Metodo IEnumCERTVIEWROW::GetMaxIndex (certview.h)

Il metodo GetMaxIndex recupera il valore di indice massimo valido dopo che è stato fatto riferimento a tutte le righe nella sequenza di enumerazione di riga.

Sintassi

HRESULT GetMaxIndex(
  [out] LONG *pIndex
);

Parametri

[out] pIndex

Puntatore a una variabile LONG contenente il valore di indice massimo per la sequenza di enumerazione di riga. Questo metodo ha esito negativo se pIndex è NULL.

Valore restituito

C++

Se il metodo ha esito positivo, il metodo restituisce S_OK e pIndex viene impostato sul valore di indice massimo per la sequenza di enumerazione di riga.

Se l'attraversamento all'ultima riga non si è verificato, questo metodo ha esito negativo con un valore restituito di E_UNEXPECTED.

Se il metodo ha esito negativo, restituisce un valore HRESULT che indica l'errore. Per un elenco dei codici di errore comuni, vedere Valori HRESULT comuni.

VB

Il valore restituito è il valore di indice massimo per la sequenza di enumerazione di riga. Questo metodo ha esito negativo se l'attraversamento all'ultima riga non si è verificato.

Commenti

Il completamento corretto di questo metodo dipende dal raggiungimento dell'ultima riga della sequenza di enumerazione. L'indice di riga massimo può essere utile per ridimensionare una barra di scorrimento o una finestra di visualizzazione, ma può anche essere a elevato utilizzo di risorse per il calcolo perché richiede la valutazione dell'intera query. Per alcune query, i dati delle colonne per ogni riga devono essere esaminati per determinare se sono inclusi nella vista. Dopo che l'utente ha eseguito il paging di tutti i dati o ha richiesto esplicitamente di procedere alla fine, viene mantenuto l'indice di riga massimo.

Per spostarsi nella sequenza di enumerazione di riga, chiamare i metodi seguenti.

Metodo Descrizione
IEnumCERTVIEWROW::Reset Passa all'inizio della sequenza di enumerazione.
IEnumCERTVIEWROW::Next Passa alla riga successiva nella sequenza di enumerazione.
IEnumCERTVIEWROW::Skip Ignora un numero specificato di righe.
 

Esempio

#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);

Requisiti

Requisito Valore
Client minimo supportato Nessuno supportato
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione certview.h (include Certsrv.h)
Libreria Certidl.lib
DLL Certadm.dll

Vedi anche

IEnumCERTVIEWROW

IEnumCERTVIEWROW::Next

IEnumCERTVIEWROW::Reset

IEnumCERTVIEWROW::Skip