ICertProperty::RemoveFromCertificate 方法 (certenroll.h)
RemoveFromCertificate 方法會將屬性與憑證解除關聯。 呼叫 PropertyId 屬性以指定要移除的屬性。
語法
HRESULT RemoveFromCertificate(
[in] VARIANT_BOOL MachineContext,
[in] EncodingType Encoding,
[in] BSTR strCertificate
);
參數
[in] MachineContext
VARIANT_BOOL值,指出證書存儲是否位於本機計算機上。 如果存放區是 本機, 請指定VARIANT_TRUE。
[in] Encoding
EncodingType 列舉值,指定套用至 strCertificate 參數所識別之憑證字串的編碼類型。
[in] strCertificate
包含 DER 編碼憑證的 BSTR 變數。
從 Windows 7 和 Windows Server 2008 R2 開始,您可以指定憑證指紋或序號,而不是編碼的憑證。 這樣做會導致函式搜尋適當的本地存儲,以尋找相符的憑證。 請記住下列幾點:
- BSTR 必須是偶數十六進位數位。
- 忽略十六進位組之間的空格符。
- Encoding 參數必須設定為 XCN_CRYPT_STRING_HEXRAW。
- MachineContext 參數會決定使用者或計算機存放區或兩者都是搜尋的。
- 如果需要私鑰,則只會搜尋個人和要求存放區。
- 如果不需要私鑰,也會搜尋根和中繼 CA 存放區。
傳回值
如果函式成功,函式會傳回 S_OK。
如果函式失敗,它會傳回 HRESULT 值,指出錯誤。 可能的值包括 (但不限於) 下表中的這些值。 如需常見錯誤碼的清單,請參閱 一般 HRESULT 值。
傳回碼/值 | Description |
---|---|
|
找不到憑證。 |
|
找到憑證,但無法載入私鑰。 |
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | certenroll.h |
Dll | CertEnroll.dll |