NetConfigurationQueryString 関数 (netconfiguration.h)

アダプター構成オブジェクトから指定した文字列値を取得し、指定したフレームワーク文字列オブジェクトに文字列を割り当てます。

構文

NTSTATUS NetConfigurationQueryString(
  [_In_]     NETCONFIGURATION      Configuration,
  [_In_]     PCUNICODE_STRING      ValueName,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES *StringAttributes,
  [_Out_]    WDFSTRING             *WdfString
);

パラメーター

[_In_] Configuration

開かれたレジストリ キーを表す NETCONFIGURATION オブジェクトを処理します。

[_In_] ValueName

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

[_In_opt_] StringAttributes

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

[_Out_] WdfString

フレームワーク文字列オブジェクトへのハンドル。 NetAdapterCx は、レジストリ値の文字列データをこのオブジェクトに割り当てます。

戻り値

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

注釈

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

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

要件

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