NetMessageBufferSend-Funktion (lmmsg.h)

Artikel
08/24/2023

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

Die NetMessageBufferSend-Funktion sendet einen Informationspuffer an einen registrierten Nachrichtenalias.

Syntax

NET_API_STATUS NET_API_FUNCTION NetMessageBufferSend(
  [in] LPCWSTR servername,
  [in] LPCWSTR msgname,
  [in] LPCWSTR fromname,
  [in] LPBYTE  buf,
  [in] DWORD   buflen
);

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 Nachrichtenalias angibt, an den der Nachrichtenpuffer gesendet werden soll.

[in] fromname

Zeiger auf eine konstante Zeichenfolge, die angibt, von wem die Nachricht stammt. Wenn dieser Parameter NULL ist, wird die Nachricht vom lokalen Computernamen gesendet.

[in] buf

Zeiger auf einen Puffer, der den Nachrichtentext enthält. Weitere Informationen finden Sie unter Netzwerkverwaltungsfunktionspuffer.

[in] buflen

Gibt einen Wert an, der die Länge des Nachrichtentexts in Bytes enthält, auf den der buf-Parameter verweist.

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_NameNotFound	Der Benutzername konnte nicht gefunden werden.
NERR_NetworkError	Bei der Netzwerkhardware ist ein allgemeiner Fehler aufgetreten.

Hinweise

Wenn Sie diese Funktion auf einem Domänencontroller aufrufen, auf dem Active Directory ausgeführt wird, wird der Zugriff basierend auf der Zugriffssteuerungsliste (Access Control List, ACL) für das sicherungsfähige Objekt zugelassen oder verweigert. Die Standard-ACL erlaubt nur Domänenadministratoren und Kontooperatoren, diese Funktion aufzurufen. Auf einem Mitgliedsserver oder einer Arbeitsstation können nur Administratoren und Serveroperatoren diese Funktion aufrufen. Weitere Informationen finden Sie unter Sicherheitsanforderungen für die Netzwerkverwaltungsfunktionen. Weitere Informationen zu ACLs und ACEs finden Sie unter Access Control Modell.

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