Metodo IEnumCERTVIEWROW::EnumCertViewExtension (certview.h)

Articolo
02/28/2024

Il metodo EnumCertViewExtension ottiene un'istanza di una sequenza di enumerazione dell'estensione per la riga corrente della sequenza di enumerazione riga.

Sintassi

HRESULT EnumCertViewExtension(
  [in]          LONG                   Flags,
  [out, retval] IEnumCERTVIEWEXTENSION **ppenum
);

Parametri

[in] Flags

C++	Valore LONG . Deve essere zero.
VB	Valore Long . Deve essere zero.

[out, retval] ppenum

Puntatore a un puntatore di tipo IEnumCERTVIEWEXTENSION .

Valore restituito

C++

Se il metodo ha esito positivo, il metodo restituisce S_OK.

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 è un oggetto sequenza di enumerazione estensione.

Commenti

La sequenza di enumerazione dell'estensione ottenuta da questa chiamata può essere usata per enumerare le estensioni associate al certificato nella riga corrente. Questa enumerazione può essere accessibile tramite i metodi dell'interfaccia IEnumCERTVIEWEXTENSION .

Per fare riferimento a una riga diversa, chiamare uno dei metodi seguenti per passare alla sequenza di enumerazione riga:

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

// pEnumRow is previously instantiated pointer to IEnumCERTVIEWROW.
LONG       Index;
HRESULT    hr;
IEnumCERTVIEWEXTENSION * pEnumExt = NULL;
// Obtain enumerator for extensions.
hr = pEnumRow->EnumCertViewExtension(0, &pEnumExt);
if (FAILED(hr))
{
    printf("Failed EnumCertViewExtension - %x\n", hr);
    goto error;
}
// Enumerate each extension.
while (S_OK == pEnumExt->Next(&Index))
{
    // Use this extension as needed.
}
error:

// Free resources.
if (NULL != pEnumExt)
    pEnumExt->Release();

Requisiti

Requisito	Valore
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