Metodo IEnumCERTVIEWROW::Next (certview.h)

Articolo
02/23/2024

Il metodo Next passa alla riga successiva nella sequenza di enumerazione di riga.

Sintassi

HRESULT Next(
  [out] LONG *pIndex
);

Parametri

[out] pIndex

Puntatore a una variabile che contiene il valore di indice della riga successiva a cui viene fatto riferimento. Se non sono presenti altre righe da enumerare, questa variabile verrà impostata su -1. Questo metodo ha esito negativo se pIndex è NULL.

Valore restituito

C++

Se il metodo ha esito positivo, il metodo restituisce S_OK e la riga successiva viene ora fatto riferimento dalla sequenza di enumerazione di riga. Se non sono presenti più righe da enumerare, viene restituito S_FALSE e pIndex viene impostato su un valore pari a -1.

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 della riga a cui fa ora riferimento la sequenza di enumerazione di riga. Se non sono presenti più righe da enumerare, il valore restituito è -1.

Commenti

Al termine di questo metodo, è possibile enumerare le colonne, gli attributi e le estensioni associati al certificato nella riga usando i metodi delle interfacce seguenti:

Il ciclo di tutte le righe nella sequenza di enumerazione può richiedere un utilizzo elevato delle risorse per il calcolo, a seconda della query interessata e delle dimensioni della sequenza.

Esempio

// 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);
}

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