Compartir a través de

Función ImageGetCertificateData (imagehlp.h)

  • Artículo

Recupera un certificado completo de un archivo.

Sintaxis

BOOL IMAGEAPI ImageGetCertificateData(
  [in]      HANDLE            FileHandle,
  [in]      DWORD             CertificateIndex,
  [out]     LPWIN_CERTIFICATE Certificate,
  [in, out] PDWORD            RequiredLength
);

Parámetros

[in] FileHandle

Identificador del archivo de imagen. Este identificador debe abrirse para FILE_READ_DATA acceso.

[in] CertificateIndex

Índice del certificado que se va a devolver.

[out] Certificate

Puntero a una estructura de WIN_CERTIFICATE que recibe los datos del certificado. Si el búfer no es lo suficientemente grande como para contener la estructura, se produce un error en la función y el último código de error se establece en ERROR_INSUFFICIENT_BUFFER.

[in, out] RequiredLength

En la entrada, este parámetro especifica la longitud del búfer certificado en bytes. Si se ejecuta correctamente, recibe la longitud del certificado.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es TRUE.

Si se produce un error en la función, el valor devuelto es FALSE. Para recuperar información de error extendida, llame a GetLastError.

Comentarios

La estructura WIN_CERTIFICATE se define de la siguiente manera:

typedef struct _WIN_CERTIFICATE {
    DWORD       dwLength;
    WORD        wRevision;
    WORD        wCertificateType;   // WIN_CERT_TYPE_xxx
    BYTE        bCertificate[ANYSIZE_ARRAY];
} WIN_CERTIFICATE, *LPWIN_CERTIFICATE;

Todas las funciones ImageHlp, como esta, son un único subproceso. Por lo tanto, es probable que las llamadas desde más de un subproceso a esta función producirán un comportamiento inesperado o daños en la memoria. Para evitarlo, debe sincronizar todas las llamadas simultáneas de más de un subproceso a esta 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 imagehlp.h
Library Imagehlp.lib
Archivo DLL Imagehlp.dll

Consulte también

Funciones ImageHlp