MprAdminConnectionEnumEx-Funktion (mprapi.h)

Artikel
08/24/2023

Die MprAdminConnectionEnumEx-Funktion listet die aktiven Verbindungen für einen angegebenen RRAS-Server auf.

Syntax

DWORD MprAdminConnectionEnumEx(
  [in]  RAS_SERVER_HANDLE     hRasServer,
  [in]  PMPRAPI_OBJECT_HEADER pObjectHeader,
  [in]  DWORD                 dwPreferedMaxLen,
  [out] LPDWORD               lpdwEntriesRead,
  [out] LPDWORD               lpdwTotalEntries,
  [out] PRAS_CONNECTION_EX    *ppRasConn,
  [in]  LPDWORD               lpdwResumeHandle
);

Parameter

[in] hRasServer

Ein Handle für den RAS-Server, auf dem Verbindungen aufgelistet werden. Rufen Sie dieses Handle ab, indem Sie MprAdminServerConnect aufrufen.

[in] pObjectHeader

Ein Zeiger auf eine MPRAPI_OBJECT_HEADER-Struktur , die die von ppRasConn empfangene Strukturversion angibt.

[in] dwPreferedMaxLen

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

[out] lpdwEntriesRead

Ein Zeiger auf ein DWORD , das die Gesamtzahl der Verbindungen empfängt, die aus der aktuellen Position des Fortsetzens aufgelistet werden.

[out] lpdwTotalEntries

Ein Zeiger auf ein DWORD , das die Gesamtzahl der Verbindungen empfängt, die aus der aktuellen Position des Fortsetzens hätten aufgelistet werden können.

[out] ppRasConn

Ein Zeiger bei der Ausgabe auf ein Array von RAS_CONNECTION_EX Strukturen, die die aktiven Verbindungsinformationen für den RRAS-Server in hRasServer enthalten. Die Anzahl der Arrayelemente wird durch den Wert bestimmt, auf den von lpdwEntriesRead verwiesen wird.

[in] lpdwResumeHandle

Ein Zeiger auf eine DWORD-Variable , die ein Fortsetzenhandle angibt, 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_ACCESS_DENIED	Die aufrufende Anwendung verfügt nicht über ausreichende Berechtigungen.
ERROR_DDM_NOT_RUNNING	Der DDM (Demand Dial Manager) wird nicht ausgeführt.
ERROR_MORE_DATA	Bei diesem Aufruf wurden nicht alle Daten zurückgegeben. Um zusätzliche Daten abzurufen, rufen Sie die Funktion mithilfe des Resume-Handles erneut auf.
ERROR_PROC_NOT_FOUND	Die angegebene Prozedur wurde nicht gefunden.
Andere	Ein Fehler von MprError.h, RasError.h oder WinError.h.

Hinweise

Der Aufrufer sollte den Speicher freigeben, auf den ppRasConn verweist, indem er die Funktion MprAdminBufferFree aufruft.

Anforderungen

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

Weitere Informationen

MprAdminBufferFree

MprAdminConnectionEnum

MprAdminServerConnect

RAS-Verwaltungsfunktionen

Referenz zur Remotezugriffsdienstverwaltung

Freigeben über