CertEnumCRLsInStore 函式 (wincrypt.h)
CertEnumCRLsInStore函式會擷取證書存儲中第一個或下一個憑證撤銷清單 (CRL) 內容。 在迴圈中使用,此函式可以依序擷取證書存儲中的所有 CRL 內容。
語法
PCCRL_CONTEXT CertEnumCRLsInStore(
[in] HCERTSTORE hCertStore,
[in] PCCRL_CONTEXT pPrevCrlContext
);
參數
[in] hCertStore
憑證存放區的控制碼。
[in] pPrevCrlContext
找到上一個 CRL_CONTEXT 結構的指標。 pPrevCrlCoNtext參數必須是Null,才能取得存放區中的第一個 CRL。 後續 CRL 的列舉方式是將 pPrevCrlCoNtext 設定為先前呼叫函式所傳回的指標。 此函式會釋放此參數的非Null值所參考的CRL_CONTEXT。 列舉會略過 先前由 CertDeleteCRLFromStore 刪除的任何 CRL。
傳回值
如果函式成功,傳回值會是存放區中下一 個CRL_CONTEXT 的指標。
如果函式失敗,則會傳回Null。 如需擴充的錯誤資訊,請呼叫 GetLastError。 接下來有一些可能的錯誤碼。
傳回碼 | 描述 |
---|---|
|
hCertStore參數中的控制碼與pPrevCrlCoNtext所指向之憑證內容中的控制碼不同。 |
|
找不到 CRL。 如果存放區是空的,或到達商店清單的結尾,就會發生這種情況。 |
備註
在後續呼叫函式時,會釋放傳回的指標當做 pPrevCrlCoNtext 傳遞。 否則,必須藉由呼叫 CertFreeCRLCoNtext來明確釋放指標。 透過呼叫CertFreeCRLCoNtext傳遞至此函式時,一律會釋放不是Null的pPrevCrlCoNtext,即使函式本身傳回錯誤也一樣。
呼叫CertDuplicateCRLCoNtext即可建立此函式所傳回的 CRL內容複本。
規格需求
最低支援的用戶端 | Windows XP [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows Server 2003 [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | wincrypt.h |
程式庫 | Crypt32.lib |
Dll | Crypt32.dll |