共用方式為

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 支援函式