ICertProperty：：SetValueOnCertificate 方法 (certenroll.h)

SetValueOnCertificate 方法會將屬性值與現有的憑證產生關聯。

語法

HRESULT SetValueOnCertificate(
  [in] VARIANT_BOOL MachineContext,
  [in] EncodingType Encoding,
  [in] BSTR         strCertificate
);

[in] MachineContext

指出證書存儲是否為本機計算機或目前使用者的 VARIANT_BOOL 值。為計算機指定 VARIANT_TRUE ，併為使用者指定 VARIANT_FALSE 。

[in] Encoding

EncodingType 列舉值，指定套用至 strCertificate 參數所識別之憑證字串的 Unicode 編碼類型。

[in] strCertificate

包含 DER 編碼憑證的 BSTR 變數。

從 Windows 7 和 Windows Server 2008 R2 開始，您可以指定憑證指紋或序號，而不是編碼的憑證。這樣做會導致函式搜尋適當的本地存儲，以尋找相符的憑證。請記住下列幾點：

如果函式成功，函式會傳回 S_OK。

如果函式失敗，它會傳回 HRESULT 值，指出錯誤。可能的值包括 (但不限於) 下表中的這些值。如需常見錯誤碼的清單，請參閱一般 HRESULT 值。

傳回碼/值	Description
CRYPT_E_NOT_FOUND	找不到憑證。
CRYPT_E_UNEXPECTED_MSG_TYPE	找到憑證，但無法載入私鑰。

呼叫 InitializeDecode 方法或 InitializeFromCertificate 方法來建立屬性值。呼叫任一方法之前，您必須先設定 PropertyId 屬性，以指定要初始化的屬性值。