NetConfigurationQueryBinary 関数 (netconfiguration.h)

  • [アーティクル]

指定されたレジストリ値に現在割り当てられているデータを取得し、フレームワークによって割り当てられたバッファーにデータを格納し、バッファーを表すフレームワーク メモリ オブジェクトを作成します。

構文

NTSTATUS NetConfigurationQueryBinary(
  [_In_]     NETCONFIGURATION      Configuration,
  [_In_]     PCUNICODE_STRING      ValueName,
  [_In_]     POOL_TYPE             PoolType,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES *MemoryAttributes,
  [_Out_]    WDFMEMORY             *Memory
);

パラメーター

[_In_] Configuration

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

[_In_] ValueName

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

[_In_] PoolType

データ バッファーに割り当てるメモリの種類を指定する、 POOL_TYPE型指定された値。

[_In_opt_] MemoryAttributes

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

[_Out_] Memory

新しいメモリ オブジェクトへのハンドルを受け取る場所へのポインター。 フレームワークは、このメモリ バッファーを割り当て、NETCONFIGURATION オブジェクトが閉じられたときに自動的に解放します。

戻り値

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

注釈

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

この関数によって割り当てられたメモリは、NETCONFIGURATION オブジェクトが閉じられると、フレームワークによって自動的に解放されます。

要件

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