MprAdminTransportSetInfo-Funktion (mprapi.h)

Artikel
08/24/2023

Die MprAdminTransportSetInfo-Funktion legt globale Informationen oder Standardinformationen der Clientschnittstelle oder beides für einen angegebenen Transport fest.

Syntax

DWORD MprAdminTransportSetInfo(
  [in]           MPR_SERVER_HANDLE hMprServer,
  [in]           DWORD             dwTransportId,
  [in, optional] LPBYTE            pGlobalInfo,
  [in]           DWORD             dwGlobalInfoSize,
  [in, optional] LPBYTE            pClientInterfaceInfo,
  [in]           DWORD             dwClientInterfaceInfoSize
);

Parameter

[in] hMprServer

Handle an den Router, auf dem Informationen festgelegt werden. Dieses Handle wird aus einem vorherigen Aufruf von MprAdminServerConnect abgerufen.

[in] dwTransportId

Ein DWORD-Wert , der den festzulegenden Transporttyp 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	Internetpaketaustausch
PID_NBF	NetBIOS Frames-Protokoll
PID_IPV6	Windows Server 2008 oder höher: Internetprotokoll, Version 6

[in, optional] pGlobalInfo

Zeiger auf einen Puffer, der globale Informationen für den Transport angibt. Verwenden Sie die Informationsheaderfunktionen , um Informationsheader zu bearbeiten.

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

[in] dwGlobalInfoSize

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

[in, optional] pClientInterfaceInfo

Zeiger auf einen Puffer, der Standardinformationen der Clientschnittstelle 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] dwClientInterfaceInfoSize

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

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-Parametersind null.
ERROR_NOT_ENOUGH_MEMORY	Unzureichende Ressourcen, um den Vorgang abzuschließen.
ERROR_UNKNOWN_PROTOCOL_ID	Der dwTransportId-Wert stimmt mit keinem unterstützten Transportprotokoll überein.

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

MprAdminServerConnect

MprAdminTransportGetInfo

Routerverwaltungsfunktionen

Referenz zur Routerverwaltung

Freigeben über