Freigeben über


NetMessageNameDel-Funktion (lmmsg.h)

[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