Metodo IEnumCERTVIEWATTRIBUTE::Next (certview.h)

Articolo
08/22/2023

Il metodo Next passa all'attributo successivo nella sequenza di enumerazione attributo.

Sintassi

HRESULT Next(
  [out] LONG *pIndex
);

Parametri

[out] pIndex

Puntatore a una variabile che contiene il valore di indice dell'attributo successivo a cui viene fatto riferimento. Se non sono presenti altri attributi da enumerare, questa variabile viene 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'attributo successivo viene ora fatto riferimento dalla sequenza di enumerazione attributo. Se non sono presenti altri attributi, il metodo restituisce 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 dell'attributo a cui fa ora riferimento la sequenza di enumerazione dell'attributo. Se non sono presenti altri attributi da enumerare, il valore restituito è -1.

Commenti

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

Esempio

LONG       Index;
HRESULT    hr;
BSTR       bstrAttribName = NULL;

// pEnumAttr is previously instantiated IEnumCERTVIEWATTRIBUTE object
while (S_OK == pEnumAttr->Next(&Index))
{
    // retrieve the attribute name
    hr = pEnumAttr->GetName(&bstrAttribName);
    if (FAILED(hr))
        printf("Failed GetName -  %x\n", hr );
    else
        printf("Attribute name: %ws\n", bstrAttribName);
}

// Free resources.
if (NULL != bstrAttribName)
    SysFreeString(bstrAttribName);

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