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