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

  • Artículo

El método Next se mueve a la siguiente fila de la secuencia de enumeración de filas.

Sintaxis

HRESULT Next(
  [out] LONG *pIndex
);

Parámetros

[out] pIndex

Puntero a una variable que contiene el valor de índice de la siguiente fila a la que se hace referencia. Si no hay más filas que enumerar, esta variable se establecerá 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 filas hace referencia a la siguiente fila. Si no hay más filas que enumerar, se 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 de la fila a la que ahora hace referencia la secuencia de enumeración de filas. Si no hay más filas para enumerar, el valor devuelto es –1.

Comentarios

Tras completar correctamente este método, las columnas, los atributos y las extensiones asociados al certificado de la fila se pueden enumerar mediante los métodos de las interfaces siguientes:

Recorrer en bucle todas las filas de la secuencia de enumeración puede consumir muchos recursos para calcular, según la consulta implicada y el tamaño de la secuencia.

Ejemplos

// pEnumRow is previously instantiated pointer to IEnumCERTVIEWROW.
LONG  Index;
LONG  nCount;

// Ensure enumerator is at first row.
if (FAILED(pEnumRow->Reset()))
    printf("Failed to Reset\n");
else
{
    nCount = 0;
    // Count the database records by enumerating the rows.
    while (S_OK == pEnumRow->Next(&Index))
        nCount++;
    // Display number of records.
    printf("Number of records is %d\n", nCount);
}

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

Consulte también

IEnumCERTVIEWATTRIBUTE

IEnumCERTVIEWCOLUMN

IEnumCERTVIEWEXTENSION

IEnumCERTVIEWROW