NetMessageNameGetInfo-Funktion (lmmsg.h)

Artikel
08/24/2023

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

Die NetMessageNameGetInfo-Funktion ruft Informationen zu einem bestimmten Nachrichtenalias in der Nachrichtennamentabelle ab. Die Funktion erfordert, dass der Messenger-Dienst gestartet wird.

Syntax

NET_API_STATUS NET_API_FUNCTION NetMessageNameGetInfo(
  [in]  LPCWSTR servername,
  [in]  LPCWSTR msgname,
  [in]  DWORD   level,
  [out] LPBYTE  *bufptr
);

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, für den Informationen zurückgegeben werden sollen.

[in] level

Gibt die Informationsebene der Daten an. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
0	Gibt den Nachrichtenalias zurück. Der parameter bufptr verweist auf eine MSG_INFO_0-Struktur .
1	Gibt den Nachrichtenalias zurück. Der bufptr-Parameter verweist auf eine MSG_INFO_1-Struktur . Diese Ebene ist nur aus Kompatibilitätsgründen vorhanden. Die Nachrichtenweiterleitung wird nicht unterstützt.

[out] bufptr

Zeiger auf den Puffer, der die Daten empfängt. Das Format dieser Daten hängt vom Wert des level-Parameters ab. Dieser Puffer wird vom System zugeordnet und muss mithilfe der NetApiBufferFree-Funktion freigegeben werden. Weitere Informationen finden Sie unter Netzwerkverwaltungsfunktionspuffer und Netzwerkverwaltungsfunktionspufferlängen.

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_LEVEL	Der für den level-Parameter angegebene Wert ist ungültig.
ERROR_INVALID_PARAMETER	Ein Parameter ist falsch.
ERROR_NOT_ENOUGH_MEMORY	Nicht genügend Arbeitsspeicher ist verfügbar.
ERROR_NOT_SUPPORTED	Diese Anforderung wird nicht unterstützt. Dieser Fehler wird unter Windows Vista und höher zurückgegeben.
NERR_NotLocalName	Der Nachrichtenalias befindet sich nicht auf dem lokalen Computer.

Hinweise

Nur Mitglieder der lokalen Gruppe Administratoren können die NetMessageNameGetInfo-Funktion erfolgreich auf einem Remoteserver ausführen.

Um alle Nachrichtenaliasen in einer Nachrichtennamentabelle aufzulisten, können Sie die NetMessageNameEnum-Funktion aufrufen.

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 (lm.h einschließen)
Bibliothek	Netapi32.lib
DLL	Netapi32.dll