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

El método GetMaxIndex recupera el valor de índice válido máximo después de que se haya hecho referencia a todas las filas de la secuencia de enumeración de filas.

Sintaxis

HRESULT GetMaxIndex(
  [out] LONG *pIndex
);

Parámetros

[out] pIndex

Puntero a una variable LONG que contiene el valor de índice máximo de la secuencia de enumeración de fila. Este método produce un error si pIndex es NULL.

Valor devuelto

C++

Si el método se ejecuta correctamente, el método devuelve S_OK y pIndex se establece en el valor de índice máximo de la secuencia de enumeración de fila.

Si no se ha producido el recorrido a la última fila, este método produce un error con un valor devuelto de E_UNEXPECTED.

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 máximo para la secuencia de enumeración de filas. Este método produce un error si no se ha producido el recorrido a la última fila.

Comentarios

La finalización correcta de este método depende de alcanzar la última fila de la secuencia de enumeración. El índice de fila máximo puede ser útil para ajustar el tamaño de una barra de desplazamiento o una ventana de visualización, pero también puede consumir muchos recursos para calcularse porque requiere evaluar toda la consulta. En algunas consultas, se deben examinar los datos de columna de cada fila para determinar si se incluye en la vista. Después de que el usuario haya paginado todos los datos o solicitado explícitamente para continuar con el final, se conserva el índice de fila máximo.

Para navegar por la secuencia de enumeración de filas, llame a los métodos siguientes.

Método	Descripción
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

#include <windows.h>
#include <stdio.h>
#include <Certview.h>

long nMax;

//  Determine the maximum row index.
hr = pRow->GetMaxIndex(&nMax);
if (FAILED(hr))
    printf("Failed GetMaxIndex [%x]\n", hr);
else
    printf("Max index is: %d\n", nMax);

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

Consulte también

IEnumCERTVIEWROW

IEnumCERTVIEWROW::Next

IEnumCERTVIEWROW::Reset

IEnumCERTVIEWROW::Skip