Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
[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 |
|---|---|
|
Gibt den Nachrichtenalias zurück. Der parameter bufptr verweist auf eine MSG_INFO_0-Struktur . |
|
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 |
|---|---|
|
Der Aufrufer hat nicht den entsprechenden Zugriff, um den Vorgang abzuschließen. |
|
Der für den level-Parameter angegebene Wert ist ungültig. |
|
Ein Parameter ist falsch. |
|
Nicht genügend Arbeitsspeicher ist verfügbar. |
|
Diese Anforderung wird nicht unterstützt. Dieser Fehler wird unter Windows Vista und höher zurückgegeben. |
|
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 |