GetComputerNameA-Funktion (winbase.h)

Artikel
08/27/2023

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

GetComputerName ruft nur den NetBIOS-Namen des lokalen Computers ab. Rufen Sie die GetComputerNameEx-Funktion auf, um den DNS-Hostnamen, den DNS-Domänennamen oder den vollqualifizierten DNS-Namen abzurufen. 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 Namen des virtuellen Clustersservers empfängt. Die Puffergröße sollte groß genug sein, um MAX_COMPUTERNAME_LENGTH + 1 Zeichen zu enthalten.

[in, out] nSize

Gibt bei der Eingabe die Größe des Puffers in TCHARs an. Bei der Ausgabe die Anzahl der TCHARs , die in den Zielpuffer kopiert wurden, ohne das abschließende NULL-Zeichen.

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 abschließenden NULL-Zeichens.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Wert ungleich null.

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

Hinweise

Die GetComputerName-Funktion ruft den NetBIOS-Namen ab, der beim Systemstart eingerichtet wurde. Von den Funktionen SetComputerName oder SetComputerNameEx vorgenommene Namensänderungen 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 Funktion WTSQuerySessionInformation .

Beispiele

Ein Beispiel finden Sie unter Abrufen von Systeminformationen.

Hinweis

Der winbase.h-Header definiert GetComputerName 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


Unterstützte Mindestversion (Client)	Windows 2000 Professional [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	winbase.h (Windows.h einschließen)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll