MprAdminServerGetInfo-Funktion (mprapi.h)

Artikel
02/29/2024

Die Funktion MprAdminServerGetInfo ruft Informationen zum angegebenen RRAS-Server ab.

Syntax

DWORD MprAdminServerGetInfo(
  [in]  MPR_SERVER_HANDLE hMprServer,
  [in]  DWORD             dwLevel,
  [out] LPBYTE            *lplpbBuffer
);

Parameter

[in] hMprServer

Handle an den Router, der abgefragt werden soll. Rufen Sie dieses Handle ab, indem Sie MprAdminServerConnect aufrufen.

[in] dwLevel

Ein DWORD-Wert, der das Format beschreibt, in dem die Informationen im lplpBuffer-Parameter zurückgegeben werden. Zulässige Werte für dwLevel sind 0, 1 und 2, wie in der folgenden Tabelle aufgeführt.

Wert	Strukturformat
0	Windows 2000 Server oder höher: MPR_SERVER_0
1	Windows Server 2003 oder höher: MPR_SERVER_1
2	Windows Server 2008 oder höher: MPR_SERVER_2

[out] lplpbBuffer

Nach erfolgreichem Abschluss ein Zeiger auf eine MPR_SERVER_0 , MPR_SERVER_1,
oder MPR_SERVER_2 Struktur. Der dwLevel-Parameter gibt den Typ der Struktur an. Freigeben des Arbeitsspeichers für diesen Puffer mit MprAdminBufferFree

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert NO_ERROR.

Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der folgenden Fehlercodes.

Wert	Bedeutung
ERROR_ACCESS_DENIED	Die aufrufende Anwendung verfügt nicht über ausreichende Berechtigungen.
ERROR_INVALID_PARAMETER	Der lplpbBuffer-Parameter ist NULL.
RPC_S_INVALID_BINDING	Der hMprServer-Parameter ist NULL.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	mprapi.h
Bibliothek	Mprapi.lib
DLL	Mprapi.dll