NetConfigurationAssignUlong-Funktion (netconfiguration.h)
Die NetConfigurationAssignUlong-Funktion schreibt einen vom Aufrufer bereitgestellten wert ohne Vorzeichen in einen angegebenen Wertnamen in der Registrierung.
Syntax
NTSTATUS NetConfigurationAssignUlong(
[_In_] NETCONFIGURATION Configuration,
[_In_] PCUNICODE_STRING ValueName,
[_In_] ULONG Value
);
Parameter
[_In_] Configuration
Ein Handle für ein NETCONFIGURATION-Objekt, das einen geöffneten Registrierungsschlüssel darstellt.
[_In_] ValueName
Ein Zeiger auf eine UNICODE_STRING-Struktur , die einen Wertnamen enthält.
[_In_] Value
Ein ULONG-Wert, der dem Wertnamen zugewiesen wird, den ValueName angibt.
Rückgabewert
Diese Funktion gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt diese Funktion möglicherweise einen entsprechenden NTSTATUS-Fehlercode zurück.
Hinweise
Der Clienttreiber ruft ein Handle für ein NETCONFIGURATION-Objekt ab, indem er NetConfigurationOpenConfiguration oder NetConfigurationOpenSubConfiguration aufruft.
Wenn unter dem geöffneten Registrierungsschlüssel bereits ein Eintrag mit demselben Namen wie ValueName vorhanden ist, ersetzt NetConfigurationAssignUlong seinen aktuellen Wert durch den vom Aufrufer angegebenen Wert. Andernfalls fügt NetConfigurationAssignUlong der Registrierung einen neuen Werteintrag mit dem angegebenen Namen und dem angegebenen Wert hinzu.
Anforderungen
Anforderung | Wert |
---|---|
Zielplattform | Universell |
KMDF-Mindestversion | 1.21 |
UMDF-Mindestversion | 2.33 |
Kopfzeile | netconfiguration.h (include netadaptercx.h) |
IRQL | PASSIVE_LEVEL |