Share via


MprAdminPortReset-Funktion (mprapi.h)

Die Funktion MprAdminPortReset setzt das Kommunikationsgerät zurück, das an den angegebenen Port angefügt ist.

Syntax

DWORD MprAdminPortReset(
  [in] RAS_SERVER_HANDLE hRasServer,
  [in] HANDLE            hPort
);

Parameter

[in] hRasServer

Handle an den RAS-Server, auf dem der angegebene Port zurückgesetzt werden soll. Rufen Sie dieses Handle ab, indem Sie MprAdminServerConnect aufrufen.

[in] hPort

Handle an den zurückzusetzenden Port. Rufen Sie dieses Handle ab, indem Sie MprAdminPortEnum 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-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_PARAMETER
Das Handle für den RAS-Server oder das Handle zum Port ist 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 dem RRAS-Verteiler ausgeliefert wird, exportiert die Funktion jedoch als RasAdminPortReset und nicht als MprAdminPortReset. Wenn Sie RRAS redistributable verwenden, verwenden Sie daher LoadLibrary und GetProcAddress , um auf diese Funktion zuzugreifen.

Anforderungen

   
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

MprAdminPortEnum

MprAdminServerConnect

RAS-Verwaltungsfunktionen

Remotezugriffsdienst-Verwaltungsreferenz