MprConfigTransportCreate-Funktion (mprapi.h)

Artikel
08/24/2023

Die MprConfigTransportCreate-Funktion fügt den angegebenen Transport der Liste der Transportprotokolle hinzu, die in der angegebenen Routerkonfiguration vorhanden sind.

Syntax

DWORD MprConfigTransportCreate(
  [in]           HANDLE hMprConfig,
  [in]           DWORD  dwTransportId,
  [in, optional] LPWSTR lpwsTransportName,
  [in]           LPBYTE pGlobalInfo,
  [in]           DWORD  dwGlobalInfoSize,
  [in, optional] LPBYTE pClientInterfaceInfo,
  [in, optional] DWORD  dwClientInterfaceInfoSize,
  [in, optional] LPWSTR lpwsDLLPath,
  [out]          HANDLE *phRouterTransport
);

Parameter

[in] hMprConfig

Handle mit der Routerkonfiguration, der der Transport hinzugefügt werden soll. Rufen Sie dieses Handle ab, indem Sie MprConfigServerConnect 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-Beendigung, die den Namen des hinzugefügten Transports angibt. Wenn dieser Parameter nicht angegeben wird, wird der dwTransportId-Parameter in eine Zeichenfolge konvertiert und als Transportname verwendet.

[in] pGlobalInfo

Zeiger auf einen Informationsheader, der globale Informationen für den Transport angibt. Der Router-Manager für den Transport interpretiert diese Informationen. Verwenden Sie die Informationsheaderfunktionen , um Informationsheader zu bearbeiten.

[in] dwGlobalInfoSize

Gibt die Größe der Daten in Bytes an, auf die der pGlobalInfo-Parameter verweist.

[in, optional] pClientInterfaceInfo

Zeiger auf einen Informationsheader, der Standardschnittstelleninformationen für Clientrouter angibt. Diese Informationen werden verwendet, um dynamische Schnittstellen für Clientrouter für diesen Transport zu konfigurieren. Verwenden Sie die Informationsheaderfunktionen , um Informationsheader zu bearbeiten.

Dieser Parameter ist optional. Die aufrufende Anwendung kann NULL für diesen Parameter angeben.

[in, optional] dwClientInterfaceInfoSize

Gibt die Größe der Daten in Bytes an, auf die der pClientInterfaceInfo-Parameter verweist. Wenn die aufrufende Anwendung NULL für pClientInterfaceInfo angibt, sollte die aufrufende Anwendung null für diesen Parameter angeben.

[in, optional] lpwsDLLPath

Zeiger auf eine Mit NULL endende Unicode-Zeichenfolge, die den Namen der Router-Manager-DLL für den angegebenen Transport angibt. Wenn dieser Name angegeben ist, legt die Funktion den DLL-Pfad für diesen Transport auf diesen Namen fest.

Dieser Parameter ist optional. Die aufrufende Anwendung kann NULL für diesen Parameter angeben.

[out] phRouterTransport

Ein Zeiger auf eine
HANDLE-Variable , die den im dwTransportId-Parameter angegebenen Transportkonfigurationshandletyp empfängt.

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	Der hMprConfig-Parameter ist NULL, oder der parameter phRouterTransport ist NULL, oder beide sind 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

Wenn der angegebene Transport bereits vorhanden ist, führt MprConfigTransportCreate das Äquivalent eines MprConfigTransportSetInfo-Aufrufs unter Verwendung 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

Weitere Informationen

FormatMessage

MprConfigServerConnect

Routerkonfigurationsfunktionen

Referenz zur Routerverwaltung

Freigeben über