MprConfigInterfaceTransportSetInfo-Funktion (mprapi.h)

Artikel
08/24/2023

Die Funktion MprConfigInterfaceTransportSetInfo aktualisiert die Konfigurationsinformationen für den Client auf der angegebenen Schnittstelle und dem angegebenen Transportprotokoll.

Syntax

DWORD MprConfigInterfaceTransportSetInfo(
  [in]           HANDLE hMprConfig,
  [in]           HANDLE hRouterInterface,
  [in]           HANDLE hRouterIfTransport,
  [in, optional] LPBYTE pInterfaceInfo,
  [in, optional] DWORD  dwInterfaceInfoSize
);

Parameter

[in] hMprConfig

Verarbeiten Sie die Routerkonfiguration. Rufen Sie dieses Handle ab, indem Sie MprConfigServerConnect aufrufen.

[in] hRouterInterface

Behandeln Sie die Schnittstellenkonfiguration, in der die Informationen aktualisiert werden sollen. Rufen Sie dieses Handle ab, indem Sie MprConfigInterfaceCreate oder MprConfigInterfaceEnum aufrufen.

[in] hRouterIfTransport

Behandeln Sie die Transportkonfiguration, in der die Informationen für den Client aktualisiert werden sollen. Rufen Sie dieses Handle ab, indem Sie MprConfigInterfaceTransportAdd, MprConfigInterfaceTransportGetHandle oder MprConfigInterfaceTransportEnum aufrufen. Unterstützte Transportprotokolltypen sind unter Transportbezeichner aufgeführt.

[in, optional] pInterfaceInfo

Zeiger auf einen Informationsheader, der Konfigurationsinformationen für den Client auf der angegebenen Schnittstelle und dem angegebenen Transport enthält. Der Router-Manager für den angegebenen Transport interpretiert diese Informationen. Verwenden Sie die Informationsheaderfunktionen , um Informationsheader zu bearbeiten.

Dieser Parameter ist optional. Wenn die aufrufende Anwendung NULL für diesen Parameter angibt, aktualisiert die Funktion die Konfigurationsinformationen für den Client nicht.

[in, optional] dwInterfaceInfoSize

Gibt die Größe der Daten in Bytes an, auf die von pInterfaceInfo verwiesen wird.

Dieser Parameter ist optional. Die aufrufende Anwendung kann null für diesen Parameter angeben. Wenn pInterfaceInfo jedoch nicht NULL ist, darf dieser Parameter nicht 0 sein. Weitere Informationen finden Sie im Abschnitt mit den Hinweisen weiter unten in diesem Thema.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert NO_ERROR. Weitere Informationen finden Sie im Abschnitt mit den Hinweisen weiter unten in diesem Thema.

Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der folgenden Fehlercodes.

Wert	Bedeutung
ERROR_INVALID_PARAMETER	Mindestens eine der folgenden Optionen muss zutreffen: hMprConfig ist NULL. hRouterInterface ist NULL. hRouterIfTransport ist NULL.
ERROR_NO_SUCH_INTERFACE	Die von hRouterInterface angegebene Schnittstelle ist in der Routerkonfiguration nicht mehr vorhanden, oder der von hRouterInterface angegebene Transport ist auf der Schnittstelle nicht mehr vorhanden.
Andere	Verwenden Sie FormatMessage , um die Systemfehlermeldung abzurufen, die dem zurückgegebenen Fehlercode entspricht.

Hinweise

Wenn der pInterfaceInfo-ParameterNULL ist, tut MprConfigInterfaceTransportSetInfo nichts und gibt sofort mit dem Wert NO_ERROR zurück.

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