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

Artículo
03/14/2023

El método EnumerateExtensions recupera el identificador de objeto (OID) de la extensión actual y mueve el puntero de enumeración interno a la siguiente extensión.

Sintaxis

HRESULT EnumerateExtensions(
  [out] BSTR *pstrExtensionName
);

Parámetros

[out] pstrExtensionName

Puntero a un BSTR que contiene el OID de la extensión actual.

Valor devuelto

C++

Si el método se ejecuta correctamente, el método devuelve S_OK y el parámetro pstrExtensionName contiene el OID de la extensión actual. Se devuelve un valor de S_FALSE si ya se ha enumerado la última extensión.

Para usar este método, cree una variable de tipo BSTR , establezca la variable igual a NULL y pase la dirección de esta variable como pstrExtensionName.

Cuando haya terminado de usar el BSTR, áurelo llamando a la función SysFreeString .

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.

VB

Devuelve una cadena que contiene el OID de la extensión o una cadena vacía si ya se ha enumerado la última extensión.

Comentarios

Este método enumera las extensiones de certificado registradas en la base de datos, incluso las que están deshabilitadas y no aparecen en el certificado. Para determinar si una extensión está deshabilitada, use GetCertificateExtensionFlags para probar el bit de EXTENSION_DISABLE_FLAG de la extensión.

Cuando haya terminado de enumerar, llame al método EnumerateExtensionsClose para liberar recursos usados por las llamadas de enumeración.

Ejemplos

#include &lt;windows.h&gt;
#include &lt;stdio.h&gt;
#include &lt;Certif.h&gt;

BSTR     bstrExt = NULL;
VARIANT  varExt;
LONG     ExtFlags;
HRESULT  hr;

VariantInit(&amp;varExt);

// Enumerate the extensions.
while (S_OK ==
      (hr = pCertServerPol-&gt;EnumerateExtensions(&amp;bstrExt)))
{
  // Retrieve the extension data.
  if (FAILED(pCertServerPol-&gt;GetCertificateExtension(
                             bstrExt,
                             PROPTYPE_BINARY,
                             &amp;varExt)))
      printf("Failed GetCertificateExtension\n");
  else
  {
     // Retrieve the extension flags.
    if (FAILED(pCertServerPol-&gt;GetCertificateExtensionFlags(
                               &amp;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(&amp;varExt);

Requisitos


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