CertDeleteCertificateFromStore 函式 (wincrypt.h)

CertDeleteCertificateFromStore 函式會從證書存儲中刪除指定的憑證內容

語法

BOOL CertDeleteCertificateFromStore(
  [in] PCCERT_CONTEXT pCertContext
);

參數

[in] pCertContext

要刪除 之CERT_CONTEXT 結構的指標。

傳回值

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

如果函式失敗,傳回值為 FALSE。 如需擴充的錯誤資訊,請呼叫 GetLastError。 其中一個可能的錯誤碼如下。

傳回碼 Description
E_ACCESSDENIED
表示存放區已開啟為唯讀,且不允許刪除作業。

備註

存放區中刪除憑證之後,所有後續嘗試取得或尋找該存放區中的憑證將會失敗。 不過,在釋放所有重複的內容之前,不會釋放配置給憑證的記憶體。

即使遇到錯誤,CertDeleteCertificateFromStore 函式一律會呼叫 CertFreeCertificateContext 函式來釋放 pCertContext。 釋放 內容 可減少內容的 參考計數 。 如果參考計數達到零,則會釋放配置給憑證的記憶體。

範例

如需使用此函式的範例,請參閱 範例 C 程式:從證書存儲刪除憑證

規格需求

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

另請參閱

CertDeleteCRLFromStore

CertFreeCertificateContext

憑證函數