Compartilhar via


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

O método EnumerateExtensionsSetup inicializa o ponteiro de enumeração interna para a primeira extensão de certificado associada ao contexto atual.

Sintaxe

HRESULT EnumerateExtensionsSetup(
  [in] LONG Flags
);

Parâmetros

[in] Flags

Esse parâmetro é reservado e deve ser definido como zero.

Retornar valor

VB

Se o método for bem-sucedido, o método retornará S_OK.

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.

Comentários

O método SetContext deve ser chamado antes de chamar esse método. A chamada para SetContext especifica qual solicitação é o contexto atual.

Para recuperar a extensão, chame o método EnumerateExtensions . A chamada para EnumerateExtensions recupera a primeira extensão e move o índice para a próxima extensão, se houver.

Exemplos

// Set the context. The value nContext (long) would be the same
// as the context parameter in ICertPolicy::VerifyRequest.
// hr is defined as an HRESULT.
// pCertServerPolicy has been used to call SetContext previously.
hr = pCertServerPolicy->SetContext( nContext );
if (FAILED(hr))
{
    printf("Failed SetContext [%x]\n", hr);
    goto error;
}
// Setup the enumeration.
hr = pCertServerPolicy->EnumerateExtensionsSetup( 0 );
if (FAILED(hr))
{
    printf("Failed EnumerateExtensionsSetup [%x]\n", hr);
    goto error;
}

Requisitos

Requisito Valor
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

EnumerateExtensions

ICertServerPolicy

Setcontext