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 |