Metodo IEnumCERTVIEWROW::EnumCertViewAttribute (certview.h)

Articolo
03/05/2024

Il metodo EnumCertViewAttribute ottiene un'istanza di una sequenza di enumerazione attributo per la riga corrente della sequenza di enumerazione di riga.

Sintassi

HRESULT EnumCertViewAttribute(
  [in]  LONG                   Flags,
  [out] IEnumCERTVIEWATTRIBUTE **ppenum
);

Parametri

[in] Flags

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

[out] ppenum

Puntatore a un puntatore di tipo IEnumCERTVIEWATTRIBUTE . Al termine di questo metodo, ppenum viene impostato su un puntatore di tipo IEnumCERTVIEWATTRIBUTE .

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 dei codici di errore comuni, vedere Valori HRESULT comuni.

VB

Il valore restituito è un oggetto sequenza di enumerazione attributo.

Commenti

La sequenza di enumerazione dell'attributo ottenuta da questa chiamata può essere utilizzata per enumerare gli attributi associati al certificato nella riga corrente. È possibile accedere a questa enumerazione tramite i metodi dell'interfaccia IEnumCERTVIEWATTRIBUTE .

Per fare riferimento a una riga diversa, chiamare uno dei metodi seguenti per spostarsi nella sequenza di enumerazione di 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
HRESULT                  hr;
LONG                     Index;
IEnumCERTVIEWATTRIBUTE * pEnumAttr = NULL;

// obtain enumerator for attributes
hr = pEnumRow->EnumCertViewAttribute(0, &pEnumAttr);
if (FAILED(hr))
{
    printf("Failed EnumCertViewAttribute - %x\n", hr);
    goto error;
}
// enumerate each attribute
while (S_OK == pEnumAttr->Next(&Index))
{
    // Use this attribute as needed.
}
error:

// Free resources.
if (NULL != pEnumAttr)
    pEnumAttr->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 (include Certsrv.h)
Libreria	Certidl.lib
DLL	Certadm.dll