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.
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 |
|---|---|
|
Das Handle für den RAS-Server oder das Handle für die RAS-Verbindung ist ungültig. |
|
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. |
|
Das hConnection-Handle ist ungültig. |
|
Das hRasServer-Handle ist ungültig. |
|
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 |