Método ICertServerPolicy::EnumerateExtensions (certif.h)

O método EnumerateExtensions recupera o identificador de objeto (OID) da extensão atual e move o ponteiro de enumeração interno para a próxima extensão.

Sintaxe

HRESULT EnumerateExtensions(
  [out] BSTR *pstrExtensionName
);

Parâmetros

[out] pstrExtensionName

Um ponteiro para um BSTR que contém o OID da extensão atual.

Valor de retorno

C++

Para usar esse método, crie uma variável de tipo de BSTR, defina a variável igual a NULL e passe o endereço dessa variável como pstrExtensionName.

Quando terminar de usar o BSTR, libere-o chamando a função SysFreeString.

Se o método falhar, ele retornará um valor HRESULT que indica o erro. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT Comuns.

VB

Observações

Esse método enumera extensões de certificado registradas no banco de dados, mesmo aquelas que estão desabilitadas e não aparecem no certificado. Para determinar se uma extensão está desabilitada, use GetCertificateExtensionFlags para testar o bit EXTENSION_DISABLE_FLAG da extensão.

Quando terminar de enumerar, chame o método EnumerateExtensionsClose para liberar recursos usados pelas chamadas de enumeração.

Exemplos

#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);

Requisitos

Consulte também

EnumerateExtensionsClose

EnumerateExtensionsSetup

GetCertificateExtension

GetCertificateExtensionFlags

ICertServerPolicy