NetMessageNameGetInfo-Funktion (lmmsg.h)

[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

Weitere Informationen

MSG_INFO_0

MSG_INFO_1

Nachrichtenfunktionen

NetMessageNameEnum

Netzwerkverwaltungsfunktionen

Übersicht über die Netzwerkverwaltung