MprConfigTransportGetHandle-Funktion (mprapi.h)

Die MprConfigTransportGetHandle-Funktion ruft ein Handle für die Konfiguration des angegebenen Transportprotokolls in der angegebenen Routerkonfiguration ab.

Syntax

DWORD MprConfigTransportGetHandle(
  [in]  HANDLE hMprConfig,
  [in]  DWORD  dwTransportId,
  [out] HANDLE *phRouterTransport
);

Parameter

[in] hMprConfig

Handle für die Routerkonfiguration. Das Handle wird aus einem vorherigen Aufruf von MprConfigServerConnect abgerufen.

[in] dwTransportId

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

Ein Zeiger auf eine
HANDLE-Variable , die den im dwTransportId-Parameter angegebenen Transportkonfigurationshandletyp empfängt.

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	Der hMprConfig-Parameter und/oder der phRouterTransport-Parameter ist NULL.
ERROR_NOT_ENOUGH_MEMORY	Unzureichende Ressourcen zum Abschließen des Vorgangs.
ERROR_UNKNOWN_PROTOCOL_ID	Das von dwTransportId angegebene Transportprotokoll wurde in der Routerkonfiguration nicht gefunden.
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

Weitere Informationen

FormatMessage

MprConfigServerConnect

Routerkonfigurationsfunktionen

Referenz zur Routerverwaltung