NetServerComputerNameDel-Funktion (lmserver.h)

Artikel
08/24/2023

Die NetServerComputerNameDel-Funktion bewirkt, dass der angegebene Server nicht mehr den emulierten Servernamen unterstützt, der durch einen vorherigen Aufruf der NetServerComputerNameAdd-Funktion festgelegt wurde. Die Funktion hebt die Bindung von Netzwerktransporten aus dem emulierten Namen auf.

Syntax

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

Parameter

[in] ServerName

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

[in] EmulatedServerName

Zeiger auf eine NULL-endende Zeichenfolge, die den emulierten Namen enthält, den der Server nicht mehr unterstützt. Der Server unterstützt weiterhin alle anderen Servernamen, die er unterstützt hat.

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 sein.

Rückgabecode	Beschreibung
ERROR_ACCESS_DENIED	Der Benutzer besitzt keinen Zugriff auf die angeforderten Informationen.
ERROR_INVALID_PARAMETER	Der angegebene Parameter ist ungültig.
ERROR_NOT_ENOUGH_MEMORY	Nicht genügend Arbeitsspeicher ist verfügbar.
NERR_NetNameNotFound	Der Freigabename ist nicht vorhanden.

Hinweise

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

Anforderungen


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