共用方式為

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

WDF_OBJECT_ATTRIBUTES 結構的指標，其中包含新 WDFSTRING 對象的驅動程式提供屬性。 此參數是選擇性的，而且可以WDF_NO_OBJECT_ATTRIBUTES。

[_Out_] WdfString

架構字串物件的句柄。 NetAdapterCx 會將登錄值的字串數據指派給這個物件。

傳回值

如果作業成功，函式會傳回STATUS_SUCCESS。 否則，此函式可能會傳回適當的NTSTATUS錯誤碼。

備註

用戶端驅動程式會呼叫 NetAdapterOpenConfiguration 或 NetConfigurationOpenSubConfiguration，以取得 NETCONFIGURATION 物件的句柄。

根據預設，架構字串物件會父代至集合物件。 用戶端驅動程式可以藉由設定 WDF_OBJECT_ATTRIBUTES 結構的 ParentObject 成員來變更此專案。

規格需求

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