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