NetMessageNameDel-Funktion (lmmsg.h)

Artikel
08/24/2023

[Diese Funktion wird ab Windows Vista nicht unterstützt, da der Messengerdienst nicht unterstützt wird.]

Die NetMessageNameDel-Funktion löscht einen Nachrichtenalias in der Nachrichtennamenstabelle. Die Funktion erfordert, dass der Messengerdienst gestartet wird.

Syntax

NET_API_STATUS NET_API_FUNCTION NetMessageNameDel(
  [in] LPCWSTR servername,
  [in] LPCWSTR msgname
);

Parameter

[in] servername

Zeiger auf eine konstante 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] msgname

Zeiger auf eine konstante Zeichenfolge, die den zu löschenden Nachrichtenalias angibt. Die Zeichenfolge darf nicht mehr als 15 Zeichen lang 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 sein.

Rückgabecode	Beschreibung
ERROR_ACCESS_DENIED	Der Aufrufer verfügt nicht über den entsprechenden Zugriff, um den Vorgang abzuschließen.
ERROR_INVALID_PARAMETER	Ein Parameter ist falsch.
ERROR_NOT_SUPPORTED	Diese Anforderung wird nicht unterstützt. Dieser Fehler wird unter Windows Vista und höher zurückgegeben.
NERR_DelComputerName	Ein Nachrichtenalias, bei dem es sich auch um einen Computernamen handelt, kann nicht gelöscht werden.
NERR_IncompleteDel	Der Nachrichtenalias wurde nicht erfolgreich aus allen Netzwerken gelöscht.
NERR_NameInUse	Der Nachrichtenalias wird derzeit verwendet. Versuchen Sie es später noch einmal.
NERR_NotLocalName	Der Nachrichtenalias befindet sich nicht auf dem lokalen Computer.

Hinweise

Nur Mitglieder der lokalen Gruppe Administratoren können die NetMessageNameDel-Funktion erfolgreich auf einem Remoteserver 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	lmmsg.h (einschließlich Lm.h)
Bibliothek	Netapi32.lib
DLL	Netapi32.dll

Weitere Informationen

Nachrichtenfunktionen

NetMessageNameAdd

Netzwerkverwaltungsfunktionen

Übersicht über die Netzwerkverwaltung

Share via