共用方式為

NetConfigurationAssignMultiString 函式 （netconfiguration.h）

  • 發行項

NetConfigurationAssignMultiString 函式會將一組字串指派給登錄中的指定值名稱。 字串包含在架構字串物件的指定集合中。

語法

NTSTATUS NetConfigurationAssignMultiString(
  [_In_] NETCONFIGURATION Configuration,
  [_In_] PCUNICODE_STRING ValueName,
  [_In_] WDFCOLLECTION    Collection
);

參數

[_In_] Configuration

代表已開啟登錄機碼之 NETCONFIGURATION 物件的句柄。

[_In_] ValueName

包含值名稱之 UNICODE_STRING 結構的指標。

[_In_] Collection

架構集合物件的句柄，表示架構字串物件的集合。

傳回值

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

言論

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

如果已開啟的登錄機碼下已有與 ValueName 相同的名稱專案，NetConfigurationAssignMultiString 會以呼叫端提供的值取代其目前值。 否則，NetConfigurationAssignMultiString 將具有指定名稱和提供值的新值專案新增至登錄。

要求

要求 價值
目標平臺 普遍
最低 KMDF 版本 1.21
最低 UMDF 版本 2.33
標頭 netconfiguration.h （包括 netadaptercx.h）
IRQL PASSIVE_LEVEL