CertEnumCTLsInStore 函式 (wincrypt.h)

發行項
03/03/2024

CertEnumCTLsInStore 函式會 (擷取證書存儲中 CTL) 內容的第一個或下一個憑證信任清單。在迴圈中使用，此函式可以依序擷取證書存儲中的所有 CTL 內容。

語法

PCCTL_CONTEXT CertEnumCTLsInStore(
  [in] HCERTSTORE    hCertStore,
  [in] PCCTL_CONTEXT pPrevCtlContext
);

參數

[in] hCertStore

證書存儲的句柄。

[in] pPrevCtlContext

找到上一個CTL_CONTEXT 結構的指標。它必須是 NULL ，才能取得存放區中的第一個 CTL。後續 CTL 的列舉方式是將 pPrevCtlContext 設定為先前呼叫所傳回的指標。此函式會釋放此參數非 NULL 值所參考的CTL_CONTEXT。列舉會略過先前由 CertDeleteCTLFromStore 刪除的任何 CTL。

傳回值

如果函式成功，則傳回值是只讀 CTL_CONTEXT的指標。

如果函式失敗且找不到 CTL，則傳回值為 NULL。如需擴充的錯誤資訊，請呼叫 GetLastError。

接下來有一些可能的錯誤碼。

傳回碼	Description
CRYPT_E_NOT_FOUND	存放區中沒有任何 CTL 存在，或函式已到達商店清單的結尾。
E_INVALIDARG	hCertStore 參數中的句柄與 pPrevCtlContext 參數所指向 CTL 內容中的句柄不同。

備註

在後續呼叫上當做 pPrevCtlContext 傳遞時，會釋放傳回的指標。否則，必須藉由呼叫 CertFreeCTLContext 來明確釋放指標。此函式一律會透過呼叫 CertFreeCTLContext () 來釋放不是 NULL 的 pPrevCtlContext，即使發生錯誤也一樣。

您可以藉由呼叫 CertDuplicateCTLContext 來建立重複專案。

規格需求

需求	值
最低支援的用戶端	Windows XP [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows Server 2003 [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	wincrypt.h
程式庫	Crypt32.lib
Dll	Crypt32.dll