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

O método EnumerateExtensions recupera o OID ( identificador de objeto ) da extensão atual e move o ponteiro de enumeração interna 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 retornado

C++

Se o método for bem-sucedido, o método retornará S_OK e o parâmetro pstrExtensionName conterá o OID da extensão atual. Um valor de S_FALSE será retornado se a última extensão já tiver sido enumerada.

Para usar esse método, crie uma variável do tipo 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

Retorna uma cadeia de caracteres que contém o OID da extensão ou uma cadeia de caracteres vazia se a última extensão já tiver sido enumerada.

Comentários

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

   
Cliente mínimo com suporte Nenhum compatível
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho certif.h (inclua Certsrv.h)
Biblioteca Certidl.lib
DLL Certcli.dll

Confira também

EnumerateExtensionsClose

EnumerateExtensionsSetup

GetCertificateExtension

GetCertificateExtensionFlags

ICertServerPolicy