imageGetCertificateData 函式 (imagehlp.h)

從檔案擷取完整的憑證。

語法

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

參數

[in] FileHandle

圖像檔的句柄。 必須開啟此句柄才能 存取FILE_READ_DATA 。

[in] CertificateIndex

要傳回之憑證的索引。

[out] Certificate

接收憑證數據 之WIN_CERTIFICATE 結構的指標。 如果緩衝區不夠大而無法包含 結構，則函式會失敗，並將最後一個錯誤碼設定為 ERROR_INSUFFICIENT_BUFFER。

[in, out] RequiredLength

在輸入時，此參數會以位元組為單位指定 憑證 緩衝區的長度。 成功時，它會收到憑證的長度。

傳回值

如果函式成功，則傳回值為 TRUE。

如果函式失敗，傳回值為 FALSE。 若要擷取擴充的錯誤資訊，請呼叫 GetLastError。

備註

WIN_CERTIFICATE結構的定義如下：

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

所有 ImageHlp 函式，例如此函式都是單個線程。 因此，從一個以上的線程呼叫此函式可能會導致非預期的行為或記憶體損毀。 若要避免這種情況，您必須將所有並行呼叫從一個以上的線程同步至此函式。

規格需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
目標平台	Windows
標頭	imagehlp.h
程式庫	Imagehlp.lib
Dll	Imagehlp.dll

另請參閱

ImageHlp 函式