MprConfigInterfaceTransportAdd-Funktion (mprapi.h)

Artikel
08/24/2023

Die MprConfigInterfaceTransportAdd-Funktion fügt einer Schnittstellenkonfiguration auf dem Router ein Transportprotokoll hinzu.

Syntax

DWORD MprConfigInterfaceTransportAdd(
  [in]           HANDLE hMprConfig,
  [in]           HANDLE hRouterInterface,
  [in]           DWORD  dwTransportId,
  [in, optional] LPWSTR lpwsTransportName,
  [in]           LPBYTE pInterfaceInfo,
  [in]           DWORD  dwInterfaceInfoSize,
  [out]          HANDLE *phRouterIfTransport
);

Parameter

[in] hMprConfig

Handle für die Routerkonfiguration. Rufen Sie dieses Handle ab, indem Sie MprConfigServerConnect aufrufen.

[in] hRouterInterface

Handle für die Schnittstellenkonfiguration, der der angegebene Transport hinzugefügt wird. Rufen Sie dieses Handle ab, indem Sie MprConfigInterfaceCreate, MprConfigInterfaceGetHandle oder MprConfigInterfaceEnum aufrufen.

[in] dwTransportId

Ein DWORD-Wert , der den Transport beschreibt, der der Konfiguration hinzugefügt werden soll. Dieser Parameter identifiziert auch den Router-Manager für den Transport. 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

[in, optional] lpwsTransportName

Zeiger auf eine Unicode-Zeichenfolge mit Null-Endung, die den Namen für den hinzugefügten Transport angibt. Wenn dieser Parameter nicht angegeben ist und der Transport IP oder IPX ist, verwendet MprConfigInterfaceTransportAdd IP oder IPX. Wenn dieser Parameter nicht angegeben ist und der Transport nicht IP oder IPX ist, konvertiert MprConfigInterfaceTransportAdd den dwTransportId-Parameter in eine Zeichenfolge und verwendet diesen als Transportnamen.

[in] pInterfaceInfo

Zeiger auf einen Informationsheader, der Informationen für die angegebene Schnittstelle und den angegebenen Transport enthält. Der Router-Manager für den angegebenen Transport interpretiert diese Informationen. Verwenden Sie die Informationsheaderfunktionen , um Informationsheader zu bearbeiten.

[in] dwInterfaceInfoSize

Gibt die Größe der Daten in Bytes an, auf die pInterfaceInfo verweist.

[out] phRouterIfTransport

Ein Zeiger auf eine
HANDLE-Variable , die den Transportkonfigurationshandletyp für diese Schnittstelle empfängt, die im dwTransportId-Parameter angegeben ist.

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_INVALID_PARAMETER	Es trifft eine der folgenden Bedingungen zu: hMprConfig ist NULL. hRouterInterface ist NULL. phRouterIfTransport ist NULL.
ERROR_NOT_ENOUGH_MEMORY	Unzureichende Ressourcen zum Abschließen des Vorgangs.
Andere	Verwenden Sie FormatMessage , um die Systemfehlermeldung abzurufen, die dem zurückgegebenen Fehlercode entspricht.

Hinweise

Zusätzlich zur Angabe eines Transports gibt der dwTransportId-Parameter auch einen Router-Manager an, da ein Router einen eindeutigen Router-Manager für jeden Transport verwaltet.

Wenn der angegebene Transport bereits vorhanden ist, führt MprConfigInterfaceTransportAdd die Entsprechung eines MprConfigInterfaceTransportSetInfo-Aufrufs mithilfe der angegebenen Parameterwerte aus.

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