MprAdminTransportCreate-Funktion (mprapi.h)

Die Funktion MprAdminTransportCreate lädt einen neuen Transport und startet den Router-Manager für den Transport.

Syntax

DWORD MprAdminTransportCreate(
  [in]           MPR_SERVER_HANDLE hMprServer,
  [in]           DWORD             dwTransportId,
  [in, optional] LPWSTR            lpwsTransportName,
  [in]           LPBYTE            pGlobalInfo,
  [in]           DWORD             dwGlobalInfoSize,
  [in, optional] LPBYTE            pClientInterfaceInfo,
  [in, optional] DWORD             dwClientInterfaceInfoSize,
  [in]           LPWSTR            lpwsDLLPath
);

Parameter

[in] hMprServer

Handle an den Router, auf dem die Informationen festgelegt werden sollen. Rufen Sie dieses Handle ab, indem Sie MprAdminServerConnect aufrufen.

[in] dwTransportId

Ein DWORD-Wert , der den festzulegenden Transportkonfigurationstyp 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

[in, optional] lpwsTransportName

Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die den Namen des Transports angibt.

[in] pGlobalInfo

Zeiger auf einen Puffer, der globale Informationen für den Transport angibt. 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 Puffer, der Standardmäßige Clientschnittstelleninformationen für den Transport angibt.

Dieser Parameter ist optional. Wenn die aufrufende Anwendung NULL für diesen Parameter angibt, legt die Funktion die Standardinformationen der Clientschnittstelle nicht fest.

[in, optional] dwClientInterfaceInfoSize

Gibt die Größe des Puffers in Bytes an, auf den der pClientInterfaceInfo-Parameter verweist.

[in] lpwsDLLPath

Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die den Pfad zur DLL für den Transport angibt.

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_PARAMETER
Der pGlobalInfo-Parameter und der pClientInterfaceInfo-Parameter sind beide NULL.
ERROR_NOT_ENOUGH_MEMORY
Unzureichende Ressourcen zum Abschließen des Vorgangs.
ERROR_PROTOCOL_ALREADY_INSTALLED
Der angegebene Transport wird bereits auf dem angegebenen Router ausgeführt.
ERROR_UNKNOWN_PROTOCOL_ID
Der DwTransportId-Wert stimmt mit keinem unterstützten Transportprotokoll ü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

MprAdminTransportGetInfo

MprAdminTransportSetInfo