SetComputerNameA-Funktion (sysinfoapi.h)

Artikel
03/02/2024

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, legt SetComputerName den NetBIOS-Namen des lokalen Computers fest, nicht den des virtuellen Clusterservers.

Um den DNS-Hostnamen oder den DNS-Domänennamen festzulegen, rufen Sie die SetComputerNameEx-Funktion 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 umfasst 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 Nichtzero-Wert.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Anwendungen, die diese Funktion verwenden, müssen über Administratorrechte verfügen.

Hinweis

Der sysinfoapi.h-Header definiert SetComputerName als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code 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
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	sysinfoapi.h (einschließlich Windows.h)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll

Siehe auch

Systeminformationsfunktionen