NetMessageNameAdd-Funktion (lmmsg.h)
[Diese Funktion wird ab Windows Vista nicht unterstützt, da der Messengerdienst nicht unterstützt wird.]
Die NetMessageNameAdd-Funktion registriert einen Nachrichtenalias in der Nachrichtennamentabelle. Die Funktion erfordert, dass der Messenger-Dienst gestartet wird.
Syntax
NET_API_STATUS NET_API_FUNCTION NetMessageNameAdd(
[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 hinzuzufügenden 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 hat nicht 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. |
|
Der Nachrichtenalias ist auf diesem Computer bereits vorhanden. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise". |
|
Der angegebene Name wird bereits als Nachrichtenalias im Netzwerk verwendet. |
|
Bei der Netzwerkhardware ist ein allgemeiner Fehler aufgetreten. |
|
Die maximale Anzahl von Nachrichtenaliasen wurde überschritten. |
Hinweise
Nur Mitglieder der lokalen Gruppe Administratoren können die NetMessageNameAdd-Funktion auf einem Remoteserver erfolgreich ausführen.
Das Forward-Aktionsflag ist kein Parameter mehr für den LAN-Manager 2. xNetMessageNameAdd-Funktion , da die Nachrichtenweiterleitung nicht mehr unterstützt wird. Wenn die NetMessageNameAdd-Funktion erkennt, dass eine weitergeleitete Version von msgname im Netzwerk vorhanden ist, schlägt die Funktion mit einem Fehler NERR_Already_Exists fehl.
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 | lmmsg.h (lm.h einschließen) |
| Bibliothek | Netapi32.lib |
| DLL | Netapi32.dll |