MprAdminPortGetInfo-Funktion (mprapi.h)

  • Artikel

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