Método IEnumCERTVIEWATTRIBUTE::Next (certview.h)

Artículo
02/26/2024

El método Next se mueve al siguiente atributo de la secuencia de enumeración de atributos.

Sintaxis

HRESULT Next(
  [out] LONG *pIndex
);

Parámetros

[out] pIndex

Puntero a una variable que contiene el valor de índice del atributo siguiente al que se hace referencia. Si no hay más atributos para enumerar, esta variable se establece en –1. Este método produce un error si pIndex es NULL.

Valor devuelto

C++

Si el método se realiza correctamente, el método devuelve S_OK y la secuencia de enumeración de atributos hace referencia al siguiente atributo. Si no hay más atributos, el método devuelve S_FALSE y pIndex se establece en un valor de –1.

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 el valor de índice del atributo al que ahora hace referencia la secuencia de enumeración de atributos. Si no hay más atributos para enumerar, el valor devuelto es –1.

Comentarios

Tras completar correctamente este método, se puede acceder al nombre y el valor del atributo a través de los métodos siguientes:

Ejemplos

LONG       Index;
HRESULT    hr;
BSTR       bstrAttribName = NULL;

// pEnumAttr is previously instantiated IEnumCERTVIEWATTRIBUTE object
while (S_OK == pEnumAttr->Next(&Index))
{
    // retrieve the attribute name
    hr = pEnumAttr->GetName(&bstrAttribName);
    if (FAILED(hr))
        printf("Failed GetName -  %x\n", hr );
    else
        printf("Attribute name: %ws\n", bstrAttribName);
}

// Free resources.
if (NULL != bstrAttribName)
    SysFreeString(bstrAttribName);

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