Función GetFriendlyNameOfCertA (cryptdlg.h)

[La función GetFriendlyNameOfCert está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. En versiones posteriores podría modificarse o no estar disponible. 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 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 NULL de terminación.

Valor devuelto

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

Comentarios

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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	cryptdlg.h
Archivo DLL	CryptDlg.dll