Metodo ISCrdEnr::getEnrolledCertificateName

Il metodo getEnrolledCertificateName recupera il nome del certificato risultante da una chiamata riuscita precedente a ISCrdEnr::registr.

Questo metodo può essere usato anche per visualizzare il certificato in una finestra di dialogo. Questo metodo chiama la funzione CryptoAPICertGetNameString.

Sintassi

HRESULT getEnrolledCertificateName(
  [in]  DWORD     dwFlags,
  [out] BSTR *pBstrCertName
);

SCrdEnr.getEnrolledCertificateName( _
  ByVal dwFlags, _
  ByRef pBstrCertName _
)

Parametri

dwFlags [in]

Valore che determina se il certificato viene visualizzato in una finestra di dialogo. Se questo valore è SCARD_ENROLL_NO_DISPLAY_CERT (definito come 0x01), il certificato registrato non viene visualizzato; tutti gli altri valori causano la visualizzazione del certificato registrato nella finestra di dialogo Certificato .

pBstrCertName [out]

Puntatore a una stringa che restituisce il nome del certificato recuperato.

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

Stringa che rappresenta il nome del certificato recuperato.

Commenti

Poiché questo metodo funziona su un certificato esistente, è necessario aver chiamato correttamente ISCrdEnr::registr prima di poter chiamare getEnrolledCertificateName.

Il metodo getEnrolledCertificateName chiama la funzione CertGetNameString per recuperare il nome del certificato in base alla sequenza descritta per il valore CERT_NAME_SIMPLE_DISPLAY_TYPE del parametro dwType diCertGetNameString.

Requisiti

Vedi anche

ISCrdEnr

ISCrdEnr::registr