NetConfigurationAssignUlong 函式 (netconfiguration.h)
NetConfigurationAssignUlong 函式會將呼叫端提供的未帶正負號長字值寫入登錄中指定的值名稱。
語法
NTSTATUS NetConfigurationAssignUlong(
[_In_] NETCONFIGURATION Configuration,
[_In_] PCUNICODE_STRING ValueName,
[_In_] ULONG Value
);
參數
[_In_] Configuration
代表已開啟登錄機碼之 NETCONFIGURATION 物件的句柄。
[_In_] ValueName
包含值名稱之 UNICODE_STRING 結構的指標。
[_In_] Value
將指派給 valueName 指定之值名稱的 ULONG 值。
傳回值
如果作業成功,此函式會傳回STATUS_SUCCESS。 否則,此函式可能會傳回適當的NTSTATUS錯誤碼。
言論
用戶端驅動程式會呼叫 netAdapterOpenConfiguration 或 NetConfigurationOpenSubConfiguration來取得 NETCONFIGURATION 物件的句柄。
如果已開啟的登錄機碼下已有與 ValueName 相同的專案,NetConfigurationAssignUlong 會以呼叫端提供的值取代其目前值。 否則,NetConfigurationAssignUlong 將具有指定名稱和提供值的新值專案新增至登錄。
要求
要求 | 價值 |
---|---|
目標平臺 | 普遍 |
最低 KMDF 版本 | 1.21 |
最低 UMDF 版本 | 2.33 |
標頭 | netconfiguration.h (包括 netadaptercx.h) |
IRQL | PASSIVE_LEVEL |