NetMessageNameAdd-Funktion (lmmsg.h)

Artikel
08/24/2023

[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
ERROR_ACCESS_DENIED	Der Aufrufer hat nicht 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_AlreadyExists	Der Nachrichtenalias ist auf diesem Computer bereits vorhanden. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".
NERR_DuplicateName	Der angegebene Name wird bereits als Nachrichtenalias im Netzwerk verwendet.
NERR_NetworkError	Bei der Netzwerkhardware ist ein allgemeiner Fehler aufgetreten.
NERR_TooManyNames	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

Weitere Informationen

Nachrichtenfunktionen

NetMessageNameDel

Netzwerkverwaltungsfunktionen

Übersicht über die Netzwerkverwaltung

Freigeben über