imageEnumerateCertificates 函式 (imagehlp.h)

擷取目前包含在映射檔中的憑證相關資訊。

語法

BOOL IMAGEAPI ImageEnumerateCertificates(
  [in]           HANDLE FileHandle,
  [in]           WORD   TypeFilter,
  [out]          PDWORD CertificateCount,
  [in, out]      PDWORD Indices,
  [in, optional] DWORD  IndexCount
);

參數

[in] FileHandle

要檢查之影像檔的控制碼。 必須開啟此控制碼才能存取FILE_READ_DATA。

[in] TypeFilter

傳回憑證資訊時，要當做篩選使用的憑證區段類型。 應該傳遞CERT_SECTION_TYPE_ANY，以取得影像中所有區段類型的相關資訊。

[out] CertificateCount

變數的指標，該變數會接收映射中的憑證數目，其中包含 TypeFilter 參數所指定類型的區段。 如果找不到此參數，則此參數為零。

[in, out] Indices

選擇性地提供緩衝區，以用來將索引陣列傳回至包含指定型別區段的憑證。 在查詢CERT_SECTION_TYPE_ANY時，不應該假設任何索引值的順序，也不保證會連續排序。

[in, optional] IndexCount

索引 緩衝區的大小 ，以 DWORD 為單位。 每當有 索引 時，就會檢查此參數。 如果 CertificateCount 大於 IndexCount， 索引 將會填入影像中找到的第一個 IndexCount 區段;不會傳回任何其他內容。

傳回值

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

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

備註

ImageEnumerateCertificates函式會傳回目前包含在映射檔中的憑證相關資訊。 其具有篩選功能，可讓包含任何單一類型區段的憑證 (或傳回任何類型) 。

探索到有趣憑證的索引之後，就可以將它們傳遞至 ImageGetCertificateData 函式，以取得憑證的實際主體。

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

需求

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

另請參閱

ImageGetCertificateData

ImageHlp 函式