DnsHostnameToComputerNameA-Funktion (winbase.h)
Wandelt einen DNS-Hostnamen in einen Computernamen im NetBIOS-Stil um.
Syntax
BOOL DnsHostnameToComputerNameA(
[in] LPCSTR Hostname,
[out] LPSTR ComputerName,
[in, out] LPDWORD nSize
);
Parameter
[in] Hostname
Der DNS-Name. Wenn der DNS-Name kein gültiger, übersetzbarer Name ist, schlägt die Funktion fehl. Weitere Informationen finden Sie unter Computer Names.
[out] ComputerName
Ein Zeiger auf einen Puffer, der den Computernamen 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. Empfängt bei der Ausgabe die Anzahl der TCHARs, die in den Zielpuffer kopiert, nicht einschließlich des endenden Nullzeichens.On output, receives the number of TCHARs copied to the destination buffer, not including the endating null character.
Wenn der Puffer zu klein ist, schlägt die Funktion fehl, GetLastError gibt ERROR_MORE_DATA zurück, und nSize erhält die erforderliche Puffergröße, nicht einschließlich des endenden NULL-Zeichens.
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. Mögliche Werte sind:
| Rückgabecode | Beschreibung |
|---|---|
|
Der ComputerName Puffer ist zu klein. Der nSize Parameter enthält die Anzahl der Bytes, die zum Empfangen des Namens erforderlich sind. |
Bemerkungen
Diese Funktion führt eine Textzuordnung des Namens aus. Diese Konvention beschränkt die Namen von Computern auf die gemeinsame Teilmenge der Namen. (Insbesondere wird die äußerst linke Bezeichnung des DNS-Namens auf 15 Byte OEM-Zeichen abgeschnitten.) Verwenden Sie daher diese Funktion nicht, um einen DNS-Domänennamen in einen NetBIOS-Domänennamen zu konvertieren. Es gibt keine Textzuordnung für Domänennamen.
Um eine Anwendung zu kompilieren, die diese Funktion verwendet, definieren Sie _WIN32_WINNT als 0x0500 oder höher. Weitere Informationen finden Sie unter Verwenden der Windows-Header.
Anmerkung
Der winbase.h-Header definiert DnsHostnameToComputerName 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 [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | winbase.h (enthalten Windows.h) |
| Library | Kernel32.lib |
| DLL- | Kernel32.dll |