CryptSetOIDFunctionValue 函式 (wincrypt.h)

CryptSetOIDFunctionValue 函式會為指定的編碼類型、函數名稱、OID 和值名稱設定值。

語法

BOOL CryptSetOIDFunctionValue(
  [in] DWORD      dwEncodingType,
  [in] LPCSTR     pszFuncName,
  [in] LPCSTR     pszOID,
  [in] LPCWSTR    pwszValueName,
  [in] DWORD      dwValueType,
  [in] const BYTE *pbValueData,
  [in] DWORD      cbValueData
);

參數

[in] dwEncodingType

指定要比對的編碼類型。 目前只會使用X509_ASN_ENCODING和PKCS_7_ASN_ENCODING;不過,未來可能會新增其他編碼類型。 若要符合目前的編碼類型,請使用:

X509_ASN_ENCODING |PKCS_7_ASN_ENCODING。

[in] pszFuncName

正在更新編碼類型、OID 和值名稱的函式名稱。

[in] pszOID

如果 對象標識碼 的高序字 (OID) 為非零, pszOID 是 OID 字串的指標,例如 “2.5.29.1” 或 ASCII 字符串,例如 “file”。 如果 OID 的高序字是零,則低序字會指定要當做物件標識碼使用的整數標識碼。

[in] pwszValueName

Unicode 字串的指標,其中包含要設定的值名稱。 如果這個名稱的值尚未存在,函式會建立它。

[in] dwValueType

指定要儲存為值資料的資訊類型。 此參數可以是下列其中一個值。

意義
REG_DWORD
32 位數位。
REG_EXPAND_SZ
Null 終止的 Unicode 字串,其中包含環境變數的未展開參考 (,例如 「%PATH%」) 。
REG_MULTI_SZ
以 Null 終止的 Unicode 字串陣列,以兩個 NULL 字元結尾。
REG_SZ
以 Null 結尾的 Unicode 字串。

[in] pbValueData

指向緩衝區,其中包含要針對指定值名稱儲存的數據。

[in] cbValueData

指定 pbValueData 參數所指向之資訊的大小,以位元組為單位。 如果數據的類型為 REG_SZ、REG_EXPAND_SZ 或 REG_MULTI_SZ,則大小必須包含終止 的 NULL 寬字元。

傳回值

如果函式成功,則傳回值為非零 (TRUE) 。

如果函式失敗,則傳回值為零, (FALSE) 。

規格需求

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

另請參閱

OID 支援函式