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 |
|---|---|
|
Der Aufrufer verfügt nicht über den entsprechenden Zugriff, um den Vorgang abzuschließen. |
|
Ein Parameter ist falsch. |
|
Diese Anforderung wird nicht unterstützt. Dieser Fehler wird unter Windows Vista und höher zurückgegeben. |
|
Ein Nachrichtenalias, bei dem es sich auch um einen Computernamen handelt, kann nicht gelöscht werden. |
|
Der Nachrichtenalias wurde nicht erfolgreich aus allen Netzwerken gelöscht. |
|
Der Nachrichtenalias wird derzeit verwendet. Versuchen Sie es später noch einmal. |
|
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 |