SetComputerNameA-Funktion (sysinfoapi.h)
Legt einen neuen NetBIOS-Namen für den lokalen Computer fest. Der Name wird in der Registrierung gespeichert, und die Namensänderung wird wirksam, wenn der Benutzer den Computer das nächste Mal neu startet.
Wenn der lokale Computer ein Knoten in einem Cluster ist, SetComputerName den NetBIOS-Namen des lokalen Computers und nicht die des virtuellen Clusterservers festlegt.
Rufen Sie zum Festlegen des DNS-Hostnamens oder des DNS-Domänennamens die funktion SetComputerNameEx auf.
Syntax
BOOL SetComputerNameA(
[in] LPCSTR lpComputerName
);
Parameter
[in] lpComputerName
Der Computername, der beim nächsten Starten des Computers wirksam wird. Der Name darf nicht länger als MAX_COMPUTERNAME_LENGTH Zeichen sein.
Der Standardzeichensatz enthält Buchstaben, Zahlen und die folgenden Symbole: @ # $ % ^ & ' ) ( . - _ { } ~ . Wenn dieser Parameter ein oder mehrere Zeichen enthält, die sich außerhalb des Standardzeichensatzes befinden, gibt SetComputerName- ERROR_INVALID_PARAMETER zurück.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Wert ungleich Null.
Wenn die Funktion fehlschlägt, ist der Rückgabewert null. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.
Bemerkungen
Anwendungen, die diese Funktion verwenden, müssen über Administratorrechte verfügen.
Anmerkung
Der sysinfoapi.h-Header definiert SetComputerName als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 2000 Professional [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | sysinfoapi.h (include Windows.h) |
| Library | Kernel32.lib |
| DLL- | Kernel32.dll |