NetAddAlternateComputerName-Funktion (lmjoin.h)

Die NetAddAlternateComputerName-Funktion fügt einen alternativen Namen für den angegebenen Computer hinzu.

Syntax

NET_API_STATUS NET_API_FUNCTION NetAddAlternateComputerName(
  [in, optional] LPCWSTR Server,
  [in]           LPCWSTR AlternateName,
  [in, optional] LPCWSTR DomainAccount,
  [in, optional] LPCWSTR DomainAccountPassword,
  [in]           ULONG   Reserved
);

Parameter

[in, optional] Server

Ein Zeiger auf eine konstante Zeichenfolge, die den Namen des Computers angibt, auf dem diese Funktion ausgeführt werden soll. Wenn dieser Parameter NULL ist, wird der lokale Computer verwendet.

[in] AlternateName

Ein Zeiger auf eine konstante Zeichenfolge, die den alternativen Namen angibt, der hinzugefügt werden soll. Dieser Name muss in Form eines vollqualifizierten DNS-Namens vorliegen.

[in, optional] DomainAccount

Ein Zeiger auf eine konstante Zeichenfolge, die das Domänenkonto angibt, das für den Zugriff auf das Computerkontoobjekt für den Computer verwendet werden soll, der im Server-Parameter in Active Directory angegeben ist. Wenn dieser Parameter NULL ist, werden die Anmeldeinformationen des Benutzers verwendet, der diese Routine ausführt.

Dieser Parameter wird nicht verwendet, wenn der Server zum Ausführen dieser Funktion nicht mit einer Domäne verbunden ist.

[in, optional] DomainAccountPassword

Ein Zeiger auf eine konstante Zeichenfolge, die das Kennwort angibt, das mit dem Domänenkonto übereinstimmt, das im Parameter DomainAccount übergeben wurde. Wenn dieser Parameter NULL ist, werden die Anmeldeinformationen des Benutzers verwendet, der diese Routine ausführt.

Dieser Parameter wird ignoriert, wenn der DomainAccount-ParameterNULL ist. Dieser Parameter wird nicht verwendet, wenn der Server zum Ausführen dieser Funktion nicht mit einer Domäne verbunden ist.

[in] Reserved

Für die zukünftige Verwendung reserviert. Dieser Parameter sollte NULL sein.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert NERR_Success.

Wenn die Funktion fehlschlägt, kann der Rückgabewert einer der folgenden Fehlercodes oder einer der Systemfehlercodes sein.

Rückgabecode Beschreibung
ERROR_ACCESS_DENIED
Der Zugriff wird verweigert. Dieser Fehler wird zurückgegeben, wenn der Aufrufer kein Mitglied der lokalen Gruppe Administratoren auf dem Zielcomputer war.
ERROR_INVALID_NAME
Ein name-Parameter ist falsch. Dieser Fehler wird zurückgegeben, wenn der AlternateName-Parameter keinen gültigen Namen enthält.
ERROR_INVALID_PARAMETER
Ein Parameter ist falsch. Dieser Fehler wird zurückgegeben, wenn der DomainAccount-Parameter keine gültige Domäne enthält. Dieser Fehler wird auch zurückgegeben, wenn der DomainAccount-Parameter nicht NULL ist und der DomainAccountPassword-Parameter nicht NULL ist, sondern keine Unicode-Zeichenfolge enthält.
ERROR_NOT_ENOUGH_MEMORY
Für die Verarbeitung dieses Befehls steht nicht genügend Arbeitsspeicher zur Verfügung.
ERROR_NOT_SUPPORTED
Die Anforderung wird nicht unterstützt. Dieser Fehler wird zurückgegeben, wenn der im Serverparameter angegebene Zielcomputer, auf dem diese Funktion ausgeführt wird, unter Windows 2000 und früher ausgeführt wird.
NERR_WkstaNotStarted
Der Arbeitsstationsdienst wurde nicht gestartet.
RPC_S_CALL_IN_PROGRESS
Für diesen Thread wird bereits ein Remoteprozeduraufruf ausgeführt.
RPC_S_PROTSEQ_NOT_SUPPORTED
Die Protokollsequenz des Remoteprozeduraufrufs wird nicht unterstützt.

Hinweise

Die NetAddAlternateComputerName-Funktion wird unter Windows XP und höher unterstützt.

Die NetAddAlternateComputerName-Funktion wird verwendet, um sekundäre Netzwerknamen für Computer festzulegen. Der primäre Name ist der Name, der für die Authentifizierung verwendet wird und dem Namen des Computerkontos zugeordnet ist.

Die NetAddAlternateComputerName-Funktion erfordert, dass der Aufrufer Mitglied der lokalen Gruppe Administratoren auf dem Zielcomputer ist.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile lmjoin.h (lm.h einschließen)
Bibliothek Netapi32.lib
DLL Netapi32.dll

Weitere Informationen

NetEnumerateComputerNames

NetJoinDomain

NetRemoveAlternateComputerName

NetRenameMachineInDomain

NetSetPrimaryComputerName

NetUnjoinDomain

SetComputerNameEx