共用方式為

ImageGetDigestStream 函式 (imagehlp.h)

  • 發行項

從指定的圖像檔擷取要求的數據。

語法

BOOL IMAGEAPI ImageGetDigestStream(
  [in] HANDLE          FileHandle,
  [in] DWORD           DigestLevel,
  [in] DIGEST_FUNCTION DigestFunction,
  [in] DIGEST_HANDLE   DigestHandle
);

參數

[in] FileHandle

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

[in] DigestLevel

要包含在傳回數據流中的影像層面。 此參數可以是下列一或多個值。

值 意義
CERT_PE_IMAGE_DIGEST_ALL_IMPORT_INFO
0x04
 包含所有匯入資訊。
CERT_PE_IMAGE_DIGEST_DEBUG_INFO
0x01
 包含符號偵錯資訊。
CERT_PE_IMAGE_DIGEST_RESOURCES
0x02
 包含資源資訊。

[in] DigestFunction

回呼例程的指標，用來處理數據。 如需詳細資訊，請參閱 DigestFunction。

[in] DigestHandle

使用者提供給摘要的句柄。 此參數會傳遞至 DigestFunction 做為第一個自變數。

傳回值

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

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

備註

ImageGetDigestStream 函式會根據傳遞的 DigestLevel 參數，傳回要從指定圖像文件摘要的數據。 不同呼叫的位元組順序會一致，這可確保一律會從擷取的位元組數據流產生相同的訊息摘要。

為了確保跨平臺相容性，此函式的所有實作都必須依照傳回圖像檔之各種部分的順序，以一致的方式運作。

資料應該以下順序傳回：

  1. 影像 (可執行檔和靜態數據) 資訊。
  2. 資源數據。
  3. 偵錯資訊。
如果未指定其中任何部分，則必須以相同順序傳回其餘部分。

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

規格需求

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

另請參閱

ImageHlp 函式