ICertServerPolicy：：EnumerateExtensions 方法 (certif.h)

EnumerateExtensions 方法检索当前扩展 (OID) 的对象标识符，并将内部枚举指针移动到下一个扩展。

语法

HRESULT EnumerateExtensions(
  [out] BSTR *pstrExtensionName
);

参数

[out] pstrExtensionName

指向包含当前扩展的 OID 的 BSTR 的指针。

返回值

C++

若要使用此方法，请创建 BSTR 类型的变量，将变量设置为 NULL，并将此变量的地址作为 pstrExtensionName 传递。

使用完 BSTR 后，通过调用 SysFreeString 函数来释放它。

如果方法失败，它将返回一个 指示错误的 HRESULT 值。 有关常见错误代码的列表，请参阅 通用 HRESULT 值。

VB

备注

此方法枚举数据库中记录的证书扩展，即使是那些已禁用且未显示在证书中的扩展。 若要确定是否禁用扩展，请使用 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);

要求

另请参阅

EnumerateExtensionsClose

EnumerateExtensionsSetup

GetCertificateExtension

GetCertificateExtensionFlags

ICertServerPolicy