MprAdminInterfaceTransportRemove-Funktion (mprapi.h)

  • Artikel

Die Funktion MprAdminInterfaceTransportRemove entfernt einen Transport (z. B. IP oder IPX) aus einer angegebenen Schnittstelle.

Syntax

DWORD MprAdminInterfaceTransportRemove(
  [in] MPR_SERVER_HANDLE hMprServer,
  [in] HANDLE            hInterface,
  [in] DWORD             dwTransportId
);

Parameter

[in] hMprServer

Handle an den Router, von dem der Transport entfernt wird. Rufen Sie dieses Handle ab, indem Sie MprAdminServerConnect aufrufen.

[in] hInterface

Handle mit der Schnittstelle, von der der Transport entfernt wird. Rufen Sie dieses Handle ab, indem Sie MprAdminInterfaceCreate aufrufen.

[in] dwTransportId

Ein DWORD-Wert , der den zu entfernenden Transporttyp beschreibt. Zulässige Werte für dwTransportId sind in der folgenden Tabelle aufgeführt.

Wert Transport (Protokollfamilie)
PID_ATALK Appletalk
PID_IP Internetprotokoll, Version 4
PID_IPX Internet-Paketaustausch
PID_NBF NetBIOS Frames-Protokoll
PID_IPV6 Windows Server 2008 oder höher: Internetprotokoll, Version 6

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_INTERFACE_CONNECTED
 Die angegebene Schnittstelle ist eine Bedarfswahlschnittstelle und derzeit verbunden.
ERROR_INVALID_HANDLE
 Der hInterface-Wert ist ungültig.
ERROR_NO_SUCH_INTERFACE
 Der angegebene Transport wird auf der angegebenen Schnittstelle nicht ausgeführt.
ERROR_UNKNOWN_PROTOCOL_ID
 Der dwTransportId-Wert stimmt mit keinem unterstützten Transport überein.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Nicht unterstützt
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile mprapi.h
Bibliothek Mprapi.lib
DLL Mprapi.dll

Weitere Informationen

MprAdminInterfaceErstellen

MprAdminInterfaceTransportAdd

MprAdminServerConnect

Routerverwaltungsfunktionen

Referenz zur Routerverwaltung