MprAdminInterfaceTransportAdd-Funktion (mprapi.h)

Artikel
08/24/2023

Die Funktion MprAdminInterfaceTransportAdd fügt einer angegebenen Schnittstelle einen Transport (z. B. IP oder IPX) hinzu.

Syntax

DWORD MprAdminInterfaceTransportAdd(
  [in] MPR_SERVER_HANDLE hMprServer,
  [in] HANDLE            hInterface,
  [in] DWORD             dwTransportId,
  [in] LPBYTE            pInterfaceInfo,
  [in] DWORD             dwInterfaceInfoSize
);

Parameter

[in] hMprServer

Handle für den Router, auf dem Informationen hinzugefügt werden. Rufen Sie dieses Handle ab, indem Sie MprAdminServerConnect aufrufen.

[in] hInterface

Handle für die Schnittstelle, auf der der Transport hinzugefügt wird. Dieses Handle wird durch einen vorherigen Aufruf von MprAdminInterfaceCreate abgerufen.

[in] dwTransportId

Ein DWORD-Wert , der den Transporttyp beschreibt, der der Schnittstelle hinzugefügt werden soll. 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	Internetpaketaustausch
PID_NBF	NetBIOS Frames-Protokoll
PID_IPV6	Windows Server 2008 oder höher: Internetprotokoll, Version 6

[in] pInterfaceInfo

Zeiger auf einen Informationsheader, der Schnittstelleninformationen für diesen Transport angibt. Verwenden Sie die Informationsheaderfunktionen , um Informationsheader zu bearbeiten.

[in] dwInterfaceInfoSize

Gibt die Größe der Informationen in Bytes an, auf die von pInterfaceInfo verwiesen wird.

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_INVALID_HANDLE	Der hInterface-Wert ist ungültig.
ERROR_INVALID_PARAMETER	Der pInterfaceInfo-Parameter ist NULL.
ERROR_UNKNOWN_PROTOCOL_ID	Der dwTransportId-Wert stimmt mit keinem unterstützten Transport überein.

Hinweise

Der dwTransportId-Parameter gibt auch den Router-Manager an, da ein Router für jeden Transport einen anderen Router-Manager verwendet.

Anforderungen


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