MprAdminConnectionEnum-Funktion (mprapi.h)

Artikel
03/15/2023

Mit der MprAdminConnectionEnum-Funktion werden alle aktiven Verbindungen aufgezählt.

Syntax

DWORD MprAdminConnectionEnum(
  [in]  RAS_SERVER_HANDLE hRasServer,
  [in]  DWORD             dwLevel,
  [out] LPBYTE            *lplpbBuffer,
  [in]  DWORD             dwPrefMaxLen,
  [out] LPDWORD           lpdwEntriesRead,
  [out] LPDWORD           lpdwTotalEntries,
  [in]  LPDWORD           lpdwResumeHandle
);

Parameter

[in] hRasServer

Behandeln Sie den RAS-Server, auf dem Verbindungen aufgezählt werden. Rufen Sie diesen Handle ab, indem Sie MprAdminServerConnect aufrufen.

[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 umfassen 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

[out] lplpbBuffer

Beim erfolgreichen Abschluss wird ein Zeiger auf ein Array von Strukturen angezeigt, 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 .

Um diesen Speicher freizugeben, rufen Sie MprAdminBufferFree auf.

[in] dwPrefMaxLen

Gibt die bevorzugte maximale Länge der zurückgegebenen Daten in 8-Bit-Bytes an. Wenn dwPrefMaxLen -1 ist, ist der zurückgegebene Puffer groß genug, um alle verfügbaren Informationen zu halten.

[out] lpdwEntriesRead

Zeiger auf eine DWORD-Variable . Diese Variable empfängt die Gesamtzahl der Verbindungen, die aus der aktuellen Fortsetzungsposition aufgezählt werden.

[out] lpdwTotalEntries

Zeiger auf eine DWORD-Variable . Diese Variable empfängt die Gesamtzahl der Verbindungen, die aus der aktuellen Fortsetzungsposition aufgezählt werden könnten.

[in] lpdwResumeHandle

Zeiger auf eine DWORD-Variable . Diese Variable gibt einen Fortgesetzten Handle an, der zum Fortsetzen der Enumeration verwendet wird. Der lpdwResumeHandle-Parameter ist auf dem ersten Aufruf null und bleibt bei nachfolgenden Aufrufen unverändert. Wenn der Rückgabecode ERROR_MORE_DATA ist, kann ein anderer Aufruf mit diesem Handle vorgenommen werden, um weitere Daten abzurufen. Wenn der Handle null ist, wird die Aufzählung abgeschlossen. Dieses Handle ist für andere Fehlertypen ungültig.

Rückgabewert

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

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

Wert	Bedeutung
ERROR_DDM_NOT_RUNNING	Der Demand Dial Manager (DDM) wird nicht ausgeführt, möglicherweise weil der Dynamic Interface Manager (DIM) nur auf einem LAN ausgeführt wird.
ERROR_INVALID_LEVEL	Der für dwLevel übergebene Wert ist nicht null, ein, zwei oder drei. Ebenen 1 und zwei werden nur unter Windows 2000 oder höher unterstützt. Ebene 3 wird nur unter Windows Server 2008 oder höher unterstützt.
ERROR_INVALID_PARAMETER	Mindestens eine der folgenden Parameter ist NULL oder verweist nicht auf gültigen Speicher: lplpBuffer, lpdwEntriesRead oder lpdwTotalEntriesRies.
ERROR_MORE_DATA	Nicht alle Daten wurden mit diesem Aufruf zurückgegeben. Um zusätzliche Daten zu erhalten, rufen Sie die Funktion erneut mithilfe des Lebenslauf-Handles auf.
RPC_S_INVALID_BINDING	Der im hRasServer-Parameter übergebene Handle ist NULL oder ungültig.
Andere	Fehler von MprError.h, RasError.h oder WinError.h.

Hinweise

Diese Funktion ist unter Windows NT 4.0 verfügbar, wenn die RRAS-Verteilertabelle installiert ist. Die Version von Mprapi.dll, die mit der RRAS redistributable bereitgestellt wird, exportiert jedoch die Funktion als RasAdminConnectionEnum anstelle von MprAdminConnectionEnum. Verwenden Sie daher beim Verwenden der RRAS-Redistributable LoadLibrary und GetProcAddress den Zugriff auf diese Funktion.

Anforderungen


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