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

EnumerateExtensions メソッドは、現在の拡張機能のオブジェクト識別子 (OID) を取得し、内部列挙ポインターを次の拡張機能に移動します。

構文

HRESULT EnumerateExtensions(
  [out] BSTR *pstrExtensionName
);

パラメーター

[out] pstrExtensionName

現在の拡張機能の OID を含む BSTR へのポインター。

戻り値

C++

メソッドが成功した場合、メソッドは S_OKを返し、 pstrExtensionName パラメーターには現在の拡張機能の OID が含まれます。 最後の拡張機能が既に列挙されている場合は、S_FALSE の値が返されます。

このメソッドを使用するには、 BSTR 型の変数を作成し、変数を NULL に設定し、この変数のアドレス を pstrExtensionName として渡します。

BSTR の使用が完了したら、SysFreeString 関数を呼び出して解放します。

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

VB

拡張機能の OID を含む文字列を返します。最後の拡張機能が既に列挙されている場合は空の文字列を返します。

解説

このメソッドは、データベースに記録されている証明書拡張機能を列挙します。無効で、証明書に表示されない拡張機能も含まれます。 拡張機能が無効になっているかどうかを確認するには、 GetCertificateExtensionFlags を使用して拡張機能のEXTENSION_DISABLE_FLAG ビットをテストします。

列挙が完了したら、 EnumerateExtensionsClose メソッドを呼び出して、列挙呼び出しで使用されるリソースを解放します。

例

#include <windows.h>
#include <stdio.h>
#include <Certif.h>

BSTR     bstrExt = NULL;
VARIANT  varExt;
LONG     ExtFlags;
HRESULT  hr;

VariantInit(&varExt);

// Enumerate the extensions.
while (S_OK ==
      (hr = pCertServerPol->EnumerateExtensions(&bstrExt)))
{
  // Retrieve the extension data.
  if (FAILED(pCertServerPol->GetCertificateExtension(
                             bstrExt,
                             PROPTYPE_BINARY,
                             &varExt)))
      printf("Failed GetCertificateExtension\n");
  else
  {
     // Retrieve the extension flags.
    if (FAILED(pCertServerPol->GetCertificateExtensionFlags(
                               &ExtFlags)))
        printf("Failed GetCertificateExtensionFlags\n");
    else
        // This sample will display the extension OID string,
        // the extension flags (in hex) and
        // the length of the BSTR binary ASN-encode extension.
        printf("Extension: %ws\tFlags:%x\tLength:%u\n",
               bstrExt,
               ExtFlags,
               SysStringByteLen(varExt.bstrVal));
  }
}
// Determine if hr was S_FALSE, meaning the enumeration 
// was completed, or some other error.
if (S_FALSE != hr)
    printf("Failed EnumerateExtensions - %x\n", hr);
// Free BSTR resource.
if (NULL != bstrExt)
    SysFreeString(bstrExt);
// Free VARIANT resource.
    VariantClear(&varExt);

要件

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

関連項目

EnumerateExtensionsClose

EnumerateExtensionsSetup

GetCertificateExtension

GetCertificateExtensionFlags

ICertServerPolicy