GetComputerNameA-Funktion (winbase.h)

Artikel
11/20/2024

Ruft den NetBIOS-Namen des lokalen Computers ab. Dieser Name wird beim Systemstart eingerichtet, wenn das System ihn aus der Registrierung liest.

GetComputerName ruft nur den NetBIOS-Namen des lokalen Computers ab. Rufen Sie zum Abrufen des DNS-Hostnamens, des DNS-Domänennamens oder des vollqualifizierten DNS-Namens die GetComputerNameEx--Funktion auf. Zusätzliche Informationen werden von der IADsADSystemInfo Schnittstelle bereitgestellt.

Das Verhalten dieser Funktion kann beeinflusst werden, wenn der lokale Computer ein Knoten in einem Cluster ist. Weitere Informationen finden Sie unter ResUtilGetEnvironmentWithNetName und UseNetworkName.

Syntax

BOOL GetComputerNameA(
  [out]     LPSTR   lpBuffer,
  [in, out] LPDWORD nSize
);

Parameter

[out] lpBuffer

Ein Zeiger auf einen Puffer, der den Computernamen oder den virtuellen Clusterservernamen empfängt. Die Puffergröße sollte groß genug sein, um MAX_COMPUTERNAME_LENGTH + 1 Zeichen zu enthalten.

[in, out] nSize

Gibt bei eingaben die Größe des Puffers in TCHARsan. Bei der Ausgabe die Anzahl der TCHARs in den Zielpuffer kopiert, nicht einschließlich des endenden NULL-Zeichens.

Wenn der Puffer zu klein ist, schlägt die Funktion fehl und GetLastError- gibt ERROR_BUFFER_OVERFLOW zurück. Der parameter lpnSize gibt die Größe des erforderlichen Puffers an, einschließlich des endenden Nullzeichens.

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

Die GetComputerName-Funktion ruft den netBIOS-Namen ab, der beim Systemstart eingerichtet wurde. Namensänderungen, die vom SetComputerName oder SetComputerNameEx Funktionen vorgenommen wurden, werden erst wirksam, wenn der Benutzer den Computer neu startet.

Wenn der Aufrufer unter einer Clientsitzung ausgeführt wird, gibt diese Funktion den Servernamen zurück. Verwenden Sie zum Abrufen des Clientnamens die WTSQuerySessionInformation Funktion.

Beispiele

Ein Beispiel finden Sie unter Abrufen von Systeminformationen.

Anmerkung

Der winbase.h-Header definiert GetComputerName 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 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 [Desktop-Apps \| UWP-Apps]
mindestens unterstützte Server-	Windows 2000 Server [Desktop-Apps \| UWP-Apps]
Zielplattform-	Fenster
Header-	winbase.h (enthalten Windows.h)
Library	Kernel32.lib
DLL-	Kernel32.dll