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 物件關閉時，架構會自動釋放此函式所配置的記憶體。

規格需求

需求	值
目標平台	Universal
最小 KMDF 版本	1.21
最低UMDF版本	2.33
標頭	netconfiguration.h (包含 netadaptercx.h)
IRQL	PASSIVE_LEVEL