Compartir a través de

Función GetFriendlyNameOfCertA (cryptdlg.h)

  • Artículo

[La función GetFriendlyNameOfCert está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. Puede modificarse o no estar disponible en versiones posteriores. En su lugar, use la función CertGetNameString con la marca CERT_NAME_FRIENDLY_DISPLAY_TYPE.]

La función GetFriendlyNameOfCert recupera el nombre para mostrar de un certificado.

Nota Esta función no tiene ninguna biblioteca de importación asociada. Debe usar las funciones de LoadLibrary y GetProcAddress para vincular dinámicamente a CryptDlg.dll.
 

Sintaxis

CRYPTDLGAPI DWORD GetFriendlyNameOfCertA(
  [in]  PCCERT_CONTEXT pccert,
  [out] LPSTR          pch,
  [in]  DWORD          cch
);

Parámetros

[in] pccert

Puntero al contexto del certificado cuyo nombre para mostrar se está recuperando.

[out] pch

Puntero a una cadena de caracteres que recibe el nombre para mostrar del certificado.

[in] cch

Número de caracteres asignados para pchBuffer, incluido el carácter de NULL.

Valor devuelto

El valor devuelto es el número de caracteres, incluida la terminación carácter null, en el nombre para mostrar devuelto.

Observaciones

Nota

El encabezado cryptdlg.h define GetFriendlyNameOfCert como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito Valor
cliente mínimo admitido Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de cryptdlg.h
DLL de CryptDlg.dll