MprConfigInterfaceTransportGetHandle-Funktion (mprapi.h)

Artikel
08/24/2023

Die MprConfigInterfaceTransportGetHandle-Funktion ruft ein Handle für die Transportkonfiguration einer Schnittstelle in der angegebenen Routerkonfiguration ab.

Syntax

DWORD MprConfigInterfaceTransportGetHandle(
  [in]  HANDLE hMprConfig,
  [in]  HANDLE hRouterInterface,
  [in]  DWORD  dwTransportId,
  [out] HANDLE *phRouterIfTransport
);

Parameter

[in] hMprConfig

Handle für die Routerkonfiguration. Rufen Sie dieses Handle ab, indem Sie MprConfigServerConnect aufrufen.

[in] hRouterInterface

Handle für die Schnittstellenkonfiguration. Rufen Sie dieses Handle ab, indem Sie MprConfigInterfaceCreate, MprConfigInterfaceGetHandle oder MprConfigInterfaceEnum aufrufen.

[in] dwTransportId

Ein DWORD-Wert , der den Transportkonfigurationshandletyp im parameter phRouterIfTransport 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

[out] phRouterIfTransport

Ein Zeiger auf eine
HANDLE-Variable , die den Transportkonfigurationshandletyp für diese Schnittstelle empfängt, die im dwTransportId-Parameter angegeben ist.

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_INVALID_PARAMETER	Mindestens eine der folgenden Optionen muss zutreffen: hMprConfig ist NULL. hRouterInterface ist NULL. phRouterIfTransport ist NULL.
ERROR_NOT_ENOUGH_MEMORY	Unzureichende Ressourcen zum Abschließen des Vorgangs.
ERROR_NO_SUCH_INTERFACE	Die von hRouterInterface angegebene Schnittstelle wurde in der Routerkonfiguration nicht gefunden, oder der von dwTransportId angegebene Transport wurde für die angegebene Schnittstelle nicht aktiviert.
Andere	Verwenden Sie FormatMessage , um die Systemfehlermeldung abzurufen, die dem zurückgegebenen Fehlercode entspricht.

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