Método IEnumCERTVIEWROW::EnumCertViewExtension (certview.h)

Artículo
02/28/2024

El método EnumCertViewExtension obtiene una instancia de una secuencia de enumeración de extensión para la fila actual de la secuencia de enumeración de filas.

Sintaxis

HRESULT EnumCertViewExtension(
  [in]          LONG                   Flags,
  [out, retval] IEnumCERTVIEWEXTENSION **ppenum
);

Parámetros

[in] Flags

C++	Valor LONG . Debe ser cero.
VB	Valor Long . Debe ser cero.

[out, retval] ppenum

Puntero a un puntero del tipo IEnumCERTVIEWEXTENSION .

Valor devuelto

C++

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.

VB

El valor devuelto es un objeto de secuencia de enumeración de extensión.

Comentarios

La secuencia de enumeración de extensión obtenida por esta llamada se puede usar para enumerar las extensiones asociadas al certificado de la fila actual. Se puede acceder a esta enumeración a través de los métodos de la interfaz IEnumCERTVIEWEXTENSION .

Para hacer referencia a una fila diferente, llame a uno de los métodos siguientes para navegar por la secuencia de enumeración de filas:

IEnumCERTVIEWROW::Reset: se mueve al principio de la secuencia de enumeración.
IEnumCERTVIEWROW::Next: se mueve a la siguiente fila de la secuencia de enumeración.
IEnumCERTVIEWROW::Skip: omite un número especificado de filas.

Ejemplos

// pEnumRow is previously instantiated pointer to IEnumCERTVIEWROW.
LONG       Index;
HRESULT    hr;
IEnumCERTVIEWEXTENSION * pEnumExt = NULL;
// Obtain enumerator for extensions.
hr = pEnumRow->EnumCertViewExtension(0, &pEnumExt);
if (FAILED(hr))
{
    printf("Failed EnumCertViewExtension - %x\n", hr);
    goto error;
}
// Enumerate each extension.
while (S_OK == pEnumExt->Next(&Index))
{
    // Use this extension as needed.
}
error:

// Free resources.
if (NULL != pEnumExt)
    pEnumExt->Release();

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	certview.h (incluya Certsrv.h)
Library	Certidl.lib
Archivo DLL	Certadm.dll