MprAdminTransportCreate-Funktion (mprapi.h)

Artikel
08/24/2023

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

Freigeben über