NetConfigurationAssignMultiString 関数 (netconfiguration.h)

NetConfigurationAssignMultiString 関数は、レジストリ内の指定した値の名前に文字列のセットを割り当てます。 文字列は、フレームワーク文字列オブジェクトの指定されたコレクションに含まれています。

構文

NTSTATUS NetConfigurationAssignMultiString(
  [_In_] NETCONFIGURATION Configuration,
  [_In_] PCUNICODE_STRING ValueName,
  [_In_] WDFCOLLECTION    Collection
);

パラメーター

[_In_] Configuration

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

[_In_] ValueName

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

[_In_] Collection

フレームワーク文字列オブジェクトのコレクションを表すフレームワーク コレクション オブジェクトへのハンドル。

戻り値

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

備考

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

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

必要条件