ICertServerPolicy::EnumerateExtensionsSetup メソッド (certif.h)

[アーティクル]
02/23/2024

EnumerateExtensionsSetup メソッドは、現在のコンテキストに関連付けられている最初の証明書拡張機能への内部列挙ポインターを初期化します。

構文

HRESULT EnumerateExtensionsSetup(
  [in] LONG Flags
);

パラメーター

[in] Flags

このパラメーターは予約済みであり、0 に設定する必要があります。

戻り値

VB

メソッドが成功した場合、メソッドは S_OKを返します。

メソッドが失敗した場合は、エラーを示す HRESULT 値を返します。一般的なエラーコードの一覧については、「共通 HRESULT 値」を参照してください。

注釈

このメソッドを呼び出す前に、SetContext メソッドを呼び出す必要があります。 SetContext の呼び出しでは、現在のコンテキストである要求を指定します。

拡張機能を取得するには、 EnumerateExtensions メソッドを呼び出します。 EnumerateExtensions の呼び出しは、最初の拡張機能を取得し、インデックスが存在する場合は次の拡張機能に移動します。

例

// Set the context. The value nContext (long) would be the same
// as the context parameter in ICertPolicy::VerifyRequest.
// hr is defined as an HRESULT.
// pCertServerPolicy has been used to call SetContext previously.
hr = pCertServerPolicy->SetContext( nContext );
if (FAILED(hr))
{
    printf("Failed SetContext [%x]\n", hr);
    goto error;
}
// Setup the enumeration.
hr = pCertServerPolicy->EnumerateExtensionsSetup( 0 );
if (FAILED(hr))
{
    printf("Failed EnumerateExtensionsSetup [%x]\n", hr);
    goto error;
}

要件

要件	値
サポートされている最小のクライアント	サポートなし
サポートされている最小のサーバー	Windows Server 2003 (デスクトップアプリのみ)
対象プラットフォーム	Windows
ヘッダー	certif.h (Certsrv.h を含む)
Library	Certidl.lib
[DLL]	Certcli.dll