Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |
|---|---|
|
Mindestens eine der folgenden Optionen muss zutreffen:
|
|
Unzureichende Ressourcen zum Abschließen des Vorgangs. |
|
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. |
|
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 |