MprAdminConnectionGetInfoEx-Funktion (mprapi.h)

Artikel
02/29/2024

Die Funktion MprAdminConnectionGetInfoEx ruft die Verbindungsinformationen für eine bestimmte Verbindung auf einem angegebenen RRAS-Server ab.

Syntax

DWORD MprAdminConnectionGetInfoEx(
  [in]  RAS_SERVER_HANDLE  hRasServer,
  [in]  HANDLE             hRasConnection,
  [out] PRAS_CONNECTION_EX pRasConnection
);

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] hRasConnection

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

[out] pRasConnection

Ein Zeiger bei der Ausgabe auf eine RAS_CONNECTION_EX Struktur, die die Verbindungsinformationen für den RRAS-Server in hRasServer enthält.

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 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_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 pRasConnection 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