NetSetPrimaryComputerName-Funktion (lmjoin.h)
Die NetSetPrimaryComputerName-Funktion legt den Namen des primären Computers für den angegebenen Computer fest.
Syntax
NET_API_STATUS NET_API_FUNCTION NetSetPrimaryComputerName(
[in, optional] LPCWSTR Server,
[in] LPCWSTR PrimaryName,
[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] PrimaryName
Ein Zeiger auf eine konstante Zeichenfolge, die den festzulegenden primären Namen angibt. 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, auf dem diese Funktion ausgeführt wird, nicht mit einer Domäne verknüpft ist.
[in, optional] DomainAccountPassword
Ein Zeiger auf eine konstante Zeichenfolge, die das Kennwort angibt, das mit dem Domänenkonto übereinstimmt, das im DomainAccount-Parameter ü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, auf dem diese Funktion ausgeführt wird, nicht mit einer Domäne verknüpft 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 |
|---|---|
|
Zugriff verweigert.“ Dieser Fehler wird zurückgegeben, wenn der Aufrufer kein Mitglied der lokalen Gruppe Administratoren auf dem Zielcomputer war. |
|
Ein name-Parameter ist falsch. Dieser Fehler wird zurückgegeben, wenn der PrimaryName-Parameter keinen gültigen Namen enthält. |
|
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 und der Parameter DomainAccountPassword nicht NULL ist, aber keine Unicode-Zeichenfolge enthält. |
|
Für die Verarbeitung dieses Befehls ist nicht genügend Arbeitsspeicher verfügbar. |
|
Die Anforderung wird nicht unterstützt. Dieser Fehler wird zurückgegeben, wenn der im Server-Parameter angegebene Zielcomputer, auf dem diese Funktion ausgeführt wird, unter Windows 2000 und früher ausgeführt wird. |
|
Der Arbeitsstationsdienst wurde nicht gestartet. |
|
Für diesen Thread wird bereits ein Remoteprozeduraufruf ausgeführt. |
|
Die Protokollsequenz des Remoteprozeduraufrufs wird nicht unterstützt. |
Hinweise
Die NetSetPrimaryComputerName-Funktion wird unter Windows XP und höher unterstützt.
Die NetSetPrimaryComputerName-Funktion wird als Teil von Umbenennungsvorgängen für Computer verwendet. Der angegebene Name wird aus der alternativen Namensliste entfernt, die für den Zielcomputer konfiguriert und als primärer Name konfiguriert ist. Der Name des Computerkontos wird so geändert, dass er mit dem primären Namen übereinstimmt. Der vorherige name des primären Computers wird in die liste der alternativen Computernamen verschoben, die für den Computer konfiguriert wurde.
Die NetSetPrimaryComputerName-Funktion erfordert, dass der Aufrufer Mitglied der lokalen Gruppe Administratoren auf dem Zielcomputer ist.
Anforderungen
| Anforderung | Wert |
|---|---|
| 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 |