Metodo IEnumCERTVIEWEXTENSION::Next (certview.h)

  • Articolo

Il metodo Next passa all'estensione successiva nella sequenza di enumerazione dell'estensione.

Sintassi

HRESULT Next(
  [out] LONG *pIndex
);

Parametri

[out] pIndex

Puntatore a una variabile contenente il valore di indice dell'estensione successiva a cui viene fatto riferimento. Se non sono presenti altre estensioni 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 l'estensione successiva viene ora a cui viene fatto riferimento. Se non sono presenti altre estensioni, S_FALSE viene restituito e il parametro 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 di codici di errore comuni, vedere Valori HRESULT comuni.

VB

Il valore restituito è il valore di indice dell'estensione a cui fa ora riferimento la sequenza di enumerazione dell'estensione. Se non sono presenti più estensioni da enumerare, il valore restituito è -1.

Commenti

Al termine di questo metodo, è possibile accedere al nome dell'estensione, ai flag e al valore tramite i metodi seguenti:

Esempio

LONG  Index;
LONG  nCount;

// determine the number of extensions
nCount = 0;
// pEnumExt is previously instantiated IEnumCERTVIEWEXTENSION object
while (S_OK == pEnumExt->Next(&Index))
{
    nCount++;
}
printf("Number of extensions is %d\n", nCount);

Requisiti

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

Vedi anche

IEnumCERTVIEWEXTENSION

IEnumCERTVIEWEXTENSION::GetFlags

IEnumCERTVIEWEXTENSION::GetName

IEnumCERTVIEWEXTENSION::GetValue