NetConfigurationAssignUnicodeString 函式 (netconfiguration.h)

NetConfigurationAssignUnicodeString 函式會將指定的 Unicode 字串指派給登錄中的指定值名稱。

語法

NTSTATUS NetConfigurationAssignUnicodeString(
  [_In_] NETCONFIGURATION Configuration,
  [_In_] PCUNICODE_STRING ValueName,
  [_In_] PCUNICODE_STRING Value
);

參數

[_In_] Configuration

NETCONFIGURATION 物件的句柄，表示已開啟的登錄機碼。

[_In_] ValueName

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

[_In_] Value

UNICODE_STRING 結構的指標，其中包含要指派給 ValueName 所指定值名稱的字串。

傳回值

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

備註

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

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

規格需求

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