Método ISCrdEnr::getEnrolledCertificateName

El método getEnrolledCertificateName recupera el nombre del certificado resultante de una llamada correcta anterior a ISCrdEnr::enroll.

Este método también se puede usar para mostrar el certificado en un cuadro de diálogo. Este método llama a la función CryptoAPICertGetNameString.

Sintaxis

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

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

Parámetros

dwFlags [in]

Valor que determina si el certificado se muestra en un cuadro de diálogo. Si este valor es SCARD_ENROLL_NO_DISPLAY_CERT (definido como 0x01), no se muestra el certificado inscrito; cualquier otro valor hace que el certificado inscrito se muestre en el cuadro de diálogo Certificado .

pBstrCertName [out]

Puntero a una cadena que devuelve el nombre del certificado recuperado.

Valor devuelto

C++

Si el método se realiza correctamente, el método devuelve S_OK.

Si se produce un error en el método, devuelve un valor HRESULT que indica el error. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

VB

Cadena que representa el nombre del certificado recuperado.

Comentarios

Dado que este método funciona en un certificado existente, debe haber llamado correctamente a ISCrdEnr::enroll para poder llamar a getEnrolledCertificateName.

El método getEnrolledCertificateName llama a la función CertGetNameString para recuperar el nombre del certificado según la secuencia descrita para el valor CERT_NAME_SIMPLE_DISPLAY_TYPE del parámetro dwType de CertGetNameString.

Requisitos

Requisito	Value
Cliente mínimo compatible	No se admite ninguno
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Archivo DLL	Scrdenrl.dll
IID	IID_ISCrdEnr se define como 753988a1-1357-436d-9cf5-f089bdd67d64

Consulte también

ISCrdEnr

ISCrdEnr::enroll