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

Artigo
02/26/2024

O método EnumerateAttributesSetup inicializa o ponteiro de enumeração interna para o primeiro atributo de solicitação associado ao contexto atual.

Sintaxe

HRESULT EnumerateAttributesSetup(
  [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 usar como o contexto atual.

Para recuperar o atributo, chame o método EnumerateAttributes . A chamada para EnumerateAttributes recupera o primeiro atributo e move o índice para o próximo atributo, 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->EnumerateAttributesSetup(0);
if (FAILED(hr))
{
    printf("Failed EnumerateAttributesSetup [%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