Método IEnumCERTVIEWROW::Next (certview.h)
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 |