MprAdminTransportSetInfo-Funktion (mprapi.h)

  • Artikel

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