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) の上位ワードが 0 以外の場合、pszOID は"2.5.29.1" などの OID 文字列または "file" などの ASCII 文字列へのポインターです。 OID の上位ワードが 0 の場合、下位ワードはオブジェクト識別子として使用される整数識別子を指定します。

[in] pwszValueName

設定する値の名前を含む Unicode 文字列へのポインター。 この名前の値がまだ存在しない場合は、関数によって作成されます。

[in] dwValueType

値のデータとして格納する情報の種類を指定します。 このパラメーターには、次の値のいずれかを指定できます。

値 意味
REG_DWORD
 32 ビット数値。
REG_EXPAND_SZ
 環境変数への展開されていない参照 ("%PATH%" など) を含む null で終わる Unicode 文字列。
REG_MULTI_SZ
 null で終わる Unicode 文字列の配列。2 つの NULL 文字で終わる。
REG_SZ
 NULL で終わる Unicode 文字列。

[in] pbValueData

指定した値名に格納されるデータを含むバッファーを指します。

[in] cbValueData

pbValueData パラメーターが指す情報のサイズをバイト単位で指定します。 データの型が REG_SZ、REG_EXPAND_SZ、またはREG_MULTI_SZの場合、サイズには終端 の NULL ワイド文字を含める必要があります。

戻り値

関数が成功した場合、戻り値は 0 以外 (TRUE) になります。

関数が失敗した場合、戻り値は 0 (FALSE) になります。

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー wincrypt.h
Library Crypt32.lib
[DLL] Crypt32.dll

こちらもご覧ください

OID サポート関数