MprAdminPortGetInfo-Funktion (mprapi.h)

Artikel
08/24/2023

Die MprAdminPortGetInfo-Funktion ruft Informationen für einen bestimmten Port ab.

Syntax

DWORD MprAdminPortGetInfo(
  [in]  RAS_SERVER_HANDLE hRasServer,
  [in]  DWORD             dwLevel,
  [in]  HANDLE            hPort,
  [out] LPBYTE            *lplpbBuffer
);

Parameter

[in] hRasServer

Behandeln Sie den RAS-Servercomputer, auf dem Portinformationen gesammelt werden sollen. 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 und 1, wie in der folgenden Tabelle aufgeführt.

Wert	Strukturformat
0	RAS_PORT_0
1	RAS_PORT_1

[in] hPort

Behandeln Sie den Port, für den Informationen gesammelt werden sollen. Rufen Sie dieses Handle ab, indem Sie MprAdminPortEnum aufrufen.

[out] lplpbBuffer

Bei erfolgreicher Fertigstellung ein Zeiger auf eine Struktur, die den Port beschreibt. Diese Strukturen sind vom Typ RAS_PORT_0 oder RAS_PORT_1 abhängig vom Wert des dwLevel-Parameters . Geben Sie diesen Arbeitsspeicher frei, indem Sie MprAdminBufferFree aufrufen.

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, möglicherweise weil der Dynamische Schnittstellen-Manager (DIM) so konfiguriert ist, dass er nur in einem LAN ausgeführt wird.
ERROR_INVALID_PARAMETER	Mindestens einer der folgenden Parameter ist NULL oder verweist nicht auf gültigen Arbeitsspeicher: lplpBuffer, lpdwEntriesRead oder lpdwTotalEntries.
ERROR_INVALID_PORT_HANDLE	Der hPort-Parameter ist ungültig.
ERROR_NOT_SUPPORTED	Der dwLevel-Parameter ist nicht 0.
Andere	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 im Lieferumfang der RRAS-Redistributable enthalten ist, exportiert die Funktion jedoch als RasAdminPortGetInfo und nicht als MprAdminPortGetInfo. 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

Weitere Informationen

MprAdminBufferFree

MprAdminPortEnum

MprAdminServerConnect

RAS-Verwaltungsfunktionen

Referenz zur Remotezugriffsdienstverwaltung

Freigeben über