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
Header	netconfiguration.h (netadaptercx.h を含む)
Library	NetAdapterCxStub.lib
IRQL	PASSIVE_LEVEL