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。 接下來有一些可能的錯誤碼。

傳回碼 描述
E_INVALIDARG
 hCertStore參數中的控制碼與pPrevCrlCoNtext所指向之憑證內容中的控制碼不同。
CRYPT_E_NOT_FOUND
 找不到 CRL。 如果存放區是空的，或到達商店清單的結尾，就會發生這種情況。

備註

在後續呼叫函式時，會釋放傳回的指標當做 pPrevCrlCoNtext 傳遞。 否則，必須藉由呼叫 CertFreeCRLCoNtext來明確釋放指標。 透過呼叫CertFreeCRLCoNtext傳遞至此函式時，一律會釋放不是Null的pPrevCrlCoNtext，即使函式本身傳回錯誤也一樣。

呼叫CertDuplicateCRLCoNtext即可建立此函式所傳回的 CRL內容複本。

規格需求

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

另請參閱

CRL_CONTEXT

CertDeleteCRLFromStore

CertDuplicateCRLCoNtext

CertFindCRLInStore

CertFreeCRLCoNtext

憑證撤銷清單函式

GetLastError