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

Artículo
02/28/2024

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

Sintaxis

HRESULT EnumCertViewAttribute(
  [in]  LONG                   Flags,
  [out] IEnumCERTVIEWATTRIBUTE **ppenum
);

Parámetros

[in] Flags

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

[out] ppenum

Puntero a un puntero del tipo IEnumCERTVIEWATTRIBUTE . Una vez completado correctamente este método,ppnum se establece en un puntero de tipo IEnumCERTVIEWATTRIBUTE .

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 atributos.

Comentarios

La secuencia de enumeración de atributos obtenida por esta llamada se puede usar para enumerar los atributos asociados al certificado de la fila actual. Se puede acceder a esta enumeración a través de los métodos de la interfaz IEnumCERTVIEWATTRIBUTE .

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
HRESULT                  hr;
LONG                     Index;
IEnumCERTVIEWATTRIBUTE * pEnumAttr = NULL;

// obtain enumerator for attributes
hr = pEnumRow->EnumCertViewAttribute(0, &pEnumAttr);
if (FAILED(hr))
{
    printf("Failed EnumCertViewAttribute - %x\n", hr);
    goto error;
}
// enumerate each attribute
while (S_OK == pEnumAttr->Next(&Index))
{
    // Use this attribute as needed.
}
error:

// Free resources.
if (NULL != pEnumAttr)
    pEnumAttr->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 (incluye Certsrv.h)
Library	Certidl.lib
Archivo DLL	Certadm.dll