AddLocalAlternateComputerName-Funktion

Fügt einen alternativen lokalen Netzwerknamen für den Computer hinzu, von dem aus er aufgerufen wird.

Syntax

DWORD AddLocalAlternateComputerName(
  _In_ LPCTSTR lpDnsFQHostname,
  _In_ ULONG   ulFlags
);

Parameter

lpDnsFQHostname [ In]

Der alternative Name, der hinzugefügt werden soll. Der Name muss im ComputerNameDnsFullyQualified-Format vorliegen, wie in der COMPUTER NAME _ _ FORMAT-Enumeration definiert, und die W-Funktion DnsValidateName _ muss in der Lage sein, ihn mit dem Format dnsNameHostnameFull zu überprüfen.

ulFlags [ In]

Dieser Parameter ist reserviert und muss auf 0 (null) festgelegt werden.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion ERROR _ SUCCESS zurück. Wenn die Funktion fehlschlägt, wird ein Fehlercode ungleich 0 (null) zurückgegeben. Zu den zurückgegebenen Fehlercodes gehören die folgenden:

Rückgabecode Beschreibung
FEHLER: _ UNGÜLTIGER _ PARAMETER
Gibt an, dass der lpDnsFQHostname-Parameter nicht auf einen gültigen DNS-Namen verweist oder dass der ulFlags-Parameter ungleich 0 (null) ist.
FEHLER _ NICHT _ GENÜGEND _ ARBEITSSPEICHER
Es steht nicht genügend Arbeitsspeicher zur Verfügung, um den Vorgang durchzuführen.

Anforderungen

Anforderung Wert
Bibliothek
Kernel32.lib
DLL
Kernel32.dll
Unicode- und ANSI-Name
AddLocalAlternateComputerNameW (Unicode) und AddLocalAlternateComputerNameA (ANSI)

Weitere Informationen

_FORMAT DES _ COMPUTERNAMENS

DnsValidateName _ W