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

Artículo
02/23/2024

El método EnumerateAttributesSetup inicializa el puntero de enumeración interno al primer atributo de solicitud asociado al contexto actual.

Sintaxis

HRESULT EnumerateAttributesSetup(
  [in] LONG Flags
);

Parámetros

[in] Flags

Este parámetro está reservado y debe establecerse en cero.

Valor devuelto

VB

Si el método se realiza correctamente, el método devuelve S_OK.

Si se produce un error en el método, devuelve un valor HRESULT que indica el error. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

Comentarios

Se debe llamar al método SetContext antes de llamar a este método. La llamada a SetContext especifica la solicitud que se va a usar como contexto actual.

Para recuperar el atributo, llame al método EnumerateAttributes . La llamada a EnumerateAttributes recupera el primer atributo y mueve el índice al atributo siguiente si existe alguno.

Ejemplos

// 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	Value
Cliente mínimo compatible	No se admite ninguno
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	certif.h (incluya Certsrv.h)
Library	Certidl.lib
Archivo DLL	Certcli.dll