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

Artículo
02/26/2024

El método EnumerateExtensionsSetup inicializa el puntero de enumeración interna a la primera extensión de certificado asociada al contexto actual.

Sintaxis

HRESULT EnumerateExtensionsSetup(
  [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 qué solicitud es el contexto actual.

Para recuperar la extensión, llame al método EnumerateExtensions . La llamada a EnumerateExtensions recupera la primera extensión y mueve el índice a la siguiente extensión si existe.

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->EnumerateExtensionsSetup( 0 );
if (FAILED(hr))
{
    printf("Failed EnumerateExtensionsSetup [%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