从 IIS 7 配置系统获取元数据值。
语法
HRESULT GetMetadata(
[in,
string] BSTR bstrMetadataType,
[out,
retval] VARIANT* pValue
);
parameters
bstrMetadataType
一个 BSTR
,它包含所请求的元数据的名称。
pValue
指向包含所请求元数据值的 的指针 VARIANT
。
返回值
HRESULT
。 可能的值包括(但并不限于)下表中的项。
值 | 说明 |
---|---|
S_OK | 指示操作成功。 |
ERROR_NOT_SUPPORTED | 指示不支持请求的元数据。 |
示例
下面的代码示例使用 IAppHostAdminManager::GetMetadata
方法从配置架构中检索availableSections
元数据。
#pragma once
#include <stdio.h>
#include <string.h>
#include <ahadmin.h>
int main()
{
IAppHostAdminManager * pMgr = NULL;
HRESULT hr = S_OK;
BSTR bstrMetadataName = SysAllocString( L"availableSections" );
VARIANT vtAvailableSections;
// Initialize
hr = CoInitializeEx( NULL, COINIT_MULTITHREADED );
if ( FAILED( hr ) )
{
printf_s( "ERROR: Unable to initialize\n" );
goto exit;
}
// Create
hr = CoCreateInstance( __uuidof( AppHostAdminManager ), NULL,
CLSCTX_INPROC_SERVER,
__uuidof( IAppHostAdminManager ), (void**) &pMgr );
if( FAILED( hr ) )
{
printf_s( "ERROR: Unable to create an IAppHostAdminManager instance\n" );
goto exit;
}
// Get the metadata
hr = pMgr->GetMetadata( bstrMetadataName, &vtAvailableSections );
if ( FAILED( hr ) )
{
if ( E_ACCESSDENIED == hr )
{
printf_s( "ERROR: Access to configuration denied.\n" );
printf_s( " Run sample as an administrator.\n" );
}
else
{
printf_s( "ERROR: Unable to get the requested metadata.\n" );
}
goto exit;
}
// Metadata returns in a comma-delimited string.
// Split the data and return the sections one line at a time.
wchar_t* wcMetadata = static_cast<wchar_t*>(vtAvailableSections.bstrVal);
wchar_t delim[] = L",";
wchar_t* tokenIn = NULL;
wchar_t* tokenOut = NULL;
tokenIn = wcstok_s( wcMetadata, delim, &tokenOut );
while ( tokenIn != NULL )
{
wprintf_s( L"\t%s\n", tokenIn );
tokenIn = wcstok_s( NULL, delim, &tokenOut);
}
exit:
// Exiting / Unwinding
if ( pMgr != NULL )
{
pMgr->Release();
pMgr = NULL;
}
SysFreeString( bstrMetadataName );
// Uninitialize
CoUninitialize();
return 0;
};
要求
类型 | 说明 |
---|---|
客户端 | - Windows Vista 上的 IIS 7.0 - Windows 7 上的 IIS 7.5 - Windows 8 上的 IIS 8.0 - Windows 10 上的 IIS 10.0 |
服务器 | - Windows Server 2008 上的 IIS 7.0 - Windows Server 2008 R2 上的 IIS 7.5 - Windows Server 2012 上的 IIS 8.0 - Windows Server 2012 R2 上的 IIS 8.5 - Windows Server 2016 上的 IIS 10.0 |
产品 | - IIS 7.0、IIS 7.5、IIS 8.0、IIS 8.5、IIS 10.0 - IIS Express 7.5、IIS Express 8.0、IIS Express 10.0 |
Header | Ahadmin.h |