Método ISCrdEnr::getSigningCertificateName

El método getSigningCertificateName recupera el nombre del firmante del certificado de firma.

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 getSigningCertificateName(
  [in]  DWORD     dwFlags,
  [out] BSTR *pbstrSigningCertName
);

SCrdEnr.getSigningCertificateName( _
  ByVal dwFlags, _
  ByRef pbstrSigningCertName _
)

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 de firma; cualquier otro valor da como resultado que el certificado de firma se muestre en el cuadro de diálogo Certificado .

pbstrSigningCertName [out]

Puntero a una cadena que devuelve el nombre del certificado de firma. El certificado de firma se usará para firmar la solicitud de certificado.

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 de firma. El certificado de firma se usará para firmar la solicitud de certificado.

Comentarios

El método getSigningCertificateName devuelve el nombre del firmante del certificado que ha seleccionado (u otro administrador) en una llamada correcta anterior a ISCrdEnr::selectSigningCertificate o ISCrdEnr::setSigningCertificate. Este método llama a la función CertGetNameString para recuperar el nombre del firmante según la secuencia descrita para el valor CERT_NAME_SIMPLE_DISPLAY_TYPE del parámetro dwType de CertGetNameString.

Requisitos

Consulte también

ISCrdEnr

ISCrdEnr::selectSigningCertificate