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 オブジェクトが閉じられるとフレームワークによって自動的に解放されます。

必要条件