NetConfigurationQueryMultiString 関数 (netconfiguration.h)

指定した構成オブジェクトの値名に関連付けられている MultiString 値レジストリ エントリを取得します。

構文

NTSTATUS NetConfigurationQueryMultiString(
  [_In_]     NETCONFIGURATION      Configuration,
  [_In_]     PCUNICODE_STRING      ValueName,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES *StringsAttributes,
  [_Inout_]  WDFCOLLECTION         Collection
);

パラメーター

[_In_] Configuration

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

[_In_] ValueName

デバイスのソフトウェア キーに値名を含む UNICODE_STRING 構造体へのポインター。

[_In_opt_] StringsAttributes

新しい WDFSTRING オブジェクトのドライバー指定の属性を含む WDF_OBJECT_ATTRIBUTES 構造体へのポインター。 このパラメーターは省略可能であり、WDF_NO_OBJECT_ATTRIBUTESできます。

[_Inout_] Collection

ドライバーが指定したコレクション オブジェクトへのハンドル。 関数が成功した場合は、ValueNameに割り当てられた各文字列の WDFSTRING オブジェクトを格納します。

戻り値

この関数は、操作が成功した場合にSTATUS_SUCCESSを返します。 レジストリ値が NULL の場合、NetConfigurationQueryMultiString は STATUS_OBJECT_NAME_NOT_FOUNDを返します。

備考

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

既定では、文字列はコレクション オブジェクトの親になります。 クライアント ドライバーは、WDF_OBJECT_ATTRIBUTES 構造体の ParentObject メンバーを設定することで、これを変更できます。

必要条件

要件	価値
ターゲット プラットフォーム の	万国
最小 KMDF バージョン	1.21
UMDF の最小バージョン を する	2.33
ヘッダー	netconfiguration.h (netadaptercx.h を含む)
ライブラリ	NetAdapterCxStub.lib
IRQL	PASSIVE_LEVEL