MprConfigTransportCreate-Funktion (mprapi.h)
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 |
|---|---|
|
Der hMprConfig-Parameter ist NULL, oder der parameter phRouterTransport ist NULL, oder beide sind NULL. |
|
Unzureichende Ressourcen zum Abschließen des Vorgangs. |
|
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 |