NetConfigurationAssignBinary 関数 (netconfiguration.h)

  • [アーティクル]

NetConfigurationAssignBinary 関数は、呼び出し元が指定したバイナリ データをレジストリ内の指定された値名に書き込みます。

構文

NTSTATUS NetConfigurationAssignBinary(
  [_In_]                             NETCONFIGURATION Configuration,
  [_In_]                             PCUNICODE_STRING ValueName,
  [__In_reads_bytes_(BufferLength)_] void             *Buffer,
  [_In_]                             ULONG            BufferLength
);

パラメーター

[_In_] Configuration

開かれたレジストリ キーを表す NETCONFIGURATION オブジェクトへのハンドル。

[_In_] ValueName

値名を含む UNICODE_STRING 構造体へのポインター。

[__In_reads_bytes_(BufferLength)_] Buffer

ドライバーが提供するデータを含むバッファーへのポインター。

[_In_] BufferLength

Buffer が指すバッファーの長さ (バイト単位)。

戻り値

この関数は、操作が成功した場合にSTATUS_SUCCESSを返します。 それ以外の場合、この関数は適切な NTSTATUS エラー コードを返す場合があります。

注釈

クライアント ドライバーは、 NetAdapterOpenConfiguration または NetConfigurationOpenSubConfiguration を呼び出して 、NETCONFIGURATION オブジェクトへのハンドルを取得します。

開いているレジストリ キーの下に ValueName と同じ名前のエントリが既に存在する場合、 NetConfigurationAssignBinary は現在の値を呼び出し元が指定した値に置き換えます。 それ以外の場合、 NetConfigurationAssignBinary は、指定された名前と指定された値を持つ新しい値エントリをレジストリに追加します。

要件

要件 値
対象プラットフォーム ユニバーサル
最小 KMDF バージョン 1.21
Header netconfiguration.h (netadaptercx.h を含む)
IRQL PASSIVE_LEVEL