MprAdminConnectionGetInfo-Funktion (mprapi.h)

Artikel
03/04/2024

Die Funktion MprAdminConnectionGetInfo ruft Daten zu einer bestimmten Verbindung ab.

Syntax

DWORD MprAdminConnectionGetInfo(
  [in]  RAS_SERVER_HANDLE hRasServer,
  [in]  DWORD             dwLevel,
  [in]  HANDLE            hRasConnection,
  [out] LPBYTE            *lplpbBuffer
);

Parameter

[in] hRasServer

Ein Handle für den Computer, von dem die Verbindungsinformationen abgerufen werden. Um dieses Handle zu erhalten, rufen Sie MprAdminServerConnect auf.

[in] dwLevel

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

Windows NT 4.0: Dieser Parameter muss null sein.

Wert	Strukturformat
0	RAS_CONNECTION_0
1	Windows 2000 oder höher: RAS_CONNECTION_1
2	Windows 2000 oder höher: RAS_CONNECTION_2
3	Windows Server 2008 oder höher: RAS_CONNECTION_3

[in] hRasConnection

Ein Handle für die Verbindung zum Abrufen von Daten. Um dieses Handle zu erhalten, rufen Sie MprAdminConnectionEnum auf.

[out] lplpbBuffer

Nach erfolgreicher Fertigstellung ein Zeiger auf ein Array von Strukturen, die die Verbindung beschreiben. Diese Strukturen sind vom Typ RAS_CONNECTION_0, RAS_CONNECTION_1, RAS_CONNECTION_2 oder RAS_CONNECTION_3, abhängig vom Wert des dwLevel-Parameters .

Rufen Sie MprAdminBufferFree auf, um diesen Arbeitsspeicher freizugeben.

Rückgabewert

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

Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der Fehlercodes, die in der folgenden Tabelle aufgeführt sind.

Rückgabecode	Beschreibung
ERROR_INVALID_PARAMETER	Das Handle für den RAS-Server oder das Handle für die RAS-Verbindung ist ungültig.
ERROR_INVALID_LEVEL	Der für dwLevel übergebene Wert ist nicht null, eins, zwei oder drei. Die Ebenen 1 und 2 werden nur unter Windows 2000 oder höher unterstützt. Ebene 3 wird nur unter Windows Server 2008 oder höher unterstützt.
ERROR_INTERFACE_NOT_CONNECTED	Das hConnection-Handle ist ungültig.
RPC_S_INVALID_BINDING	Das hRasServer-Handle ist ungültig.
Andere	Ein Fehler von MprError.h, RasError.h oder WinError.h.

Hinweise

Diese Funktion ist unter Windows NT 4.0 verfügbar, wenn die RRAS redistributable installiert ist. Die Version von Mprapi.dll, die in der RRAS-Verteilertabelle enthalten ist, exportiert die Funktion jedoch als RasAdminConnectionGetInfo anstelle von MprAdminConnectionGetInfo. Verwenden Sie daher bei Verwendung der RRAS redistributable LoadLibrary und GetProcAddress , um auf diese Funktion zuzugreifen.

Anforderungen

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