IAppHostAdminManager::GetMetadata メソッド
IIS 7 構成システムからメタデータ値を取得します。
構文
HRESULT GetMetadata(
[in,
string] BSTR bstrMetadataType,
[out,
retval] VARIANT* pValue
);
パラメーター
bstrMetadataType
BSTR
要求されるメタデータの名前を格納している 。
pValue
要求されたメタデータの値を含む へのポインター VARIANT
。
戻り値
HRESULT
。 有効な値を次の表に示しますが、これ以外にもあります。
値 | 説明 |
---|---|
S_OK | 操作が成功したことを示します。 |
ERROR_NOT_SUPPORTED | 要求されたメタデータがサポートされていないことを示します。 |
例
次のコード例では、 メソッドを availableSections
使用して構成スキーマからメタデータを IAppHostAdminManager::GetMetadata
取得します。
#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;
};
要件
Type | 説明 |
---|---|
Client | - 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 |