共用方式為

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
最低 UMDF 版本 2.33
標頭 netconfiguration.h （包括 netadaptercx.h）
IRQL PASSIVE_LEVEL