MprAdminConnectionEnum-Funktion (mprapi.h)

Artikel
02/29/2024

Die MprAdminConnectionEnum-Funktion listet alle aktiven Verbindungen auf.

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

Handle an den RAS-Server, auf dem Verbindungen aufgelistet werden. Rufen Sie dieses 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 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

[out] lplpbBuffer

Bei 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.

[in] dwPrefMaxLen

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

[out] lpdwEntriesRead

Zeiger auf eine DWORD-Variable . Diese Variable empfängt die Gesamtzahl der Verbindungen, die von der aktuellen Position des Lebenslaufs aufgezählt werden.

[out] lpdwTotalEntries

Zeiger auf eine DWORD-Variable . Diese Variable empfängt die Gesamtzahl der Verbindungen, die von der aktuellen Position des Fortsetzens aufgezählt worden sein könnten.

[in] lpdwResumeHandle

Zeiger auf eine DWORD-Variable . Diese Variable gibt ein Resume-Handle an, das zum Fortsetzen der Enumeration verwendet wird. Der lpdwResumeHandle-Parameter ist beim ersten Aufruf null und bleibt bei nachfolgenden Aufrufen unverändert. Wenn der Rückgabecode ERROR_MORE_DATA ist, kann mit diesem Handle ein weiterer Aufruf ausgeführt werden, um weitere Daten abzurufen. Wenn das Handle bei der Rückgabe NULL ist, ist die Enumeration abgeschlossen. Dieses Handle ist für andere Fehlerrückmeldungen ungültig.

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_DDM_NOT_RUNNING	Der DDM-Manager (Demand Dial Manager) wird nicht ausgeführt, möglicherweise weil der Dynamische Schnittstellen-Manager (DIM) nur für die Ausführung in einem LAN konfiguriert ist.
ERROR_INVALID_LEVEL	Der für dwLevel übergebene Wert ist nicht null, 1, 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_INVALID_PARAMETER	Mindestens einer der folgenden Parameter ist NULL oder verweist nicht auf gültigen Arbeitsspeicher: lplpBuffer, lpdwEntriesRead oder lpdwTotalEntries.
ERROR_MORE_DATA	Bei diesem Aufruf wurden nicht alle Daten zurückgegeben. Um zusätzliche Daten zu erhalten, rufen Sie die Funktion mithilfe des Resume-Handles erneut auf.
RPC_S_INVALID_BINDING	Das im hRasServer-Parameter übergebene Handle ist NULL oder 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 RRAS redistributable installiert ist. Die Version von Mprapi.dll, die mit der RRAS-Verteilerfunktion ausgeliefert wird, exportiert die Funktion jedoch als RasAdminConnectionEnum und nicht als MprAdminConnectionEnum. Wenn Sie RRAS redistributable verwenden, verwenden Sie daher 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