Metodo IEnumCERTVIEWROW::EnumCertViewColumn (certview.h)

Articolo
02/28/2024

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

Sintassi

HRESULT EnumCertViewColumn(
  [out] IEnumCERTVIEWCOLUMN **ppenum
);

Parametri

[out] ppenum

Puntatore a un puntatore di tipo IEnumCERTVIEWCOLUMN .

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 di colonna.

Commenti

La sequenza di enumerazione di colonna ottenuta da questa chiamata può essere utilizzata per enumerare le colonne associate al certificato nella riga corrente. È possibile accedere a questa enumerazione tramite i metodi dell'interfaccia IEnumCERTVIEWCOLUMN .

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;
IEnumCERTVIEWCOLUMN * pEnumCol = NULL;
// obtain enumerator for columns
hr = pEnumRow->EnumCertViewColumn(&pEnumCol);
if ( FAILED( hr ))
{
    printf("Failed EnumCertViewColumn - %x\n", hr );
    goto error;
}
// enumerate each column
while (S_OK == pEnumCol->Next(&Index))
{
    // Use this column as needed.
}
error:

// Free resources.
if ( NULL != pEnumCol )
    pEnumCol->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