NetServerComputerNameAdd-Funktion (lmserver.h)

Artikel
03/01/2024

Die NetServerComputerNameAdd-Funktion listet die Transporte auf, auf denen der angegebene Server aktiv ist, und bindet den emulierten Servernamen an jeden der Transporte.

NetServerComputerNameAdd ist eine Hilfsprogrammfunktion, die die Funktionalität der NetServerTransportEnum-Funktion und der NetServerTransportAddEx-Funktion kombiniert.

Syntax

NET_API_STATUS NET_API_FUNCTION NetServerComputerNameAdd(
  [in] LMSTR ServerName,
  [in] LMSTR EmulatedDomainName,
  [in] LMSTR EmulatedServerName
);

Parameter

[in] ServerName

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

[in] EmulatedDomainName

Zeiger auf eine Zeichenfolge, die den Domänennamen enthält, den der angegebene Server verwenden sollte, wenn seine Anwesenheit mithilfe von EmulatedServerName angekündigt wird. Dieser Parameter ist optional.

[in] EmulatedServerName

Zeiger auf eine null-beendete Zeichenfolge, die den emulierten Namen enthält, den der Server zusätzlich zu dem im ServerName-Parameter angegebenen Namen unterstützen sollte.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert NERR_Success. Beachten Sie, dass NetServerComputerNameAdd erfolgreich ist, wenn der angegebene emulierte Servername mindestens einem Transport hinzugefügt wird.

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

Rückgabecode	Beschreibung
ERROR_ACCESS_DENIED	Der Benutzer besitzt keinen Zugriff auf die angeforderten Informationen.
ERROR_DUP_NAME	Im Netzwerk ist ein doppelter Name vorhanden.
ERROR_INVALID_DOMAINNAME	Der Domänenname konnte im Netzwerk nicht gefunden werden.
ERROR_INVALID_PARAMETER	Der angegebene Parameter ist ungültig.
ERROR_NOT_ENOUGH_MEMORY	Es ist nicht genügend Arbeitsspeicher verfügbar.

Hinweise

Nur Mitglieder der lokalen Gruppe Administratoren oder Serveroperatoren können die NetServerComputerNameAdd-Funktion erfolgreich ausführen.

Der vom ServerName-Parameter angegebene Server unterstützt weiterhin alle namen, die er unterstützt hat, und beginnt zusätzlich mit der Unterstützung neuer Namen, die durch erfolgreiche Aufrufe der NetServerComputerNameAdd-Funktion bereitgestellt werden.

Die Namensemulation, die aus einem Aufruf von NetServerComputerNameAdd resultiert, wird beendet, wenn der Server neu gestartet oder neu gestartet wird. Um die Durch einen vorherigen Aufruf von NetServerComputerNameAdd festgelegte Namensemulation ohne Neustart oder Neustart einzustellen, können Sie die NetServerComputerNameDel-Funktion aufrufen.

Die NetServerComputerNameAdd-Funktion wird in der Regel verwendet, wenn ein Systemadministrator einen Server ersetzt, aber die Konvertierung für Benutzer transparent halten möchte.

Beispiele

Im Folgenden sehen Sie ein Beispiel für einen Aufruf der NetServerComputerNameAdd-Funktion , die anfordert, dass \Server1 auch auf Anforderungen für \Server2 antwortet.

NetServerComputerNameAdd (Server1, NULL, Server2);

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	lmserver.h (lm.h einschließen)
Bibliothek	Netapi32.lib
DLL	Netapi32.dll