BCryptSetProperty 関数 (bcrypt.h)

BCryptSetProperty 関数は、CNG オブジェクトの名前付きプロパティの値を設定します。

構文

NTSTATUS BCryptSetProperty(
  [in, out] BCRYPT_HANDLE hObject,
  [in]      LPCWSTR       pszProperty,
  [in]      PUCHAR        pbInput,
  [in]      ULONG         cbInput,
  [in]      ULONG         dwFlags
);

パラメーター

[in, out] hObject

プロパティ値を設定する CNG オブジェクトを表すハンドル。

[in] pszProperty

設定するプロパティの名前を含む null で終わる Unicode 文字列へのポインター。 これには、定義済みの Cryptography Primitive Property Identifier またはカスタム プロパティ識別子のいずれかを指定できます。

[in] pbInput

新しいプロパティ値を含むバッファーのアドレス。 cbInput パラメーターには、このバッファーのサイズが含まれています。

[in] cbInput

pbInput バッファーのサイズ (バイト単位)。

[in] dwFlags

この関数の動作を変更するフラグのセット。 この関数にはフラグは定義されていません。

戻り値

関数の成功または失敗を示す状態コードを返します。

可能な戻りコードには、以下が含まれますが、これらに限定されません。

リターン コード 形容
STATUS_SUCCESS
関数が成功しました。
STATUS_INVALID_HANDLE
hObject パラメーターのハンドルが無効です。
STATUS_INVALID_PARAMETER
1 つ以上のパラメーターが無効です。
STATUS_NOT_SUPPORTED
pszProperty パラメーターで指定された名前付きプロパティはサポートされていないか、読み取り専用です。

備考

プロバイダーがサポートするプロセッサ モードに応じて、BCryptSetProperty は、ユーザー モードまたはカーネル モードから呼び出すことができます。 カーネル モードの呼び出し元は、PASSIVE_LEVELIRQL または DISPATCH_LEVEL IRQL で実行できます。 現在の IRQL レベルが DISPATCH_LEVELされている場合、BCryptSetProperty に渡されるすべてのポインターは、非ページ (またはロックされた) メモリを参照する必要があります。 hObject パラメーターで指定されたオブジェクトがハンドルである場合は、BCRYPT_PROV_DISPATCH フラグを使用して開かれている必要があります。

カーネル モードでこの関数を呼び出すには、ドライバー開発キット (DDK) の一部である Cng.lib を使用します。 Windows Server 2008 および Windows Vista: カーネル モードでこの関数を呼び出すには、Ksecdd.lib を使用します。

プロパティ BCRYPT_CHAINING_MODEの値を設定すると、pbInput パラメーターは cbInputによってバインド 解除されます。 呼び出し元は、null で終わる有効な Unicode 文字列が指定されていることを確認する必要があります。

必要条件

要件 価値
サポートされる最小クライアント Windows Vista [デスクトップ アプリ |UWP アプリ]
サポートされる最小サーバー Windows Server 2008 [デスクトップ アプリ |UWP アプリ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー bcrypt.h
ライブラリ Bcrypt.lib
DLL Bcrypt.dll