MprAdminInterfaceTransportAdd-Funktion (mprapi.h)
Die Funktion MprAdminInterfaceTransportAdd fügt einer angegebenen Schnittstelle einen Transport (z. B. IP oder IPX) hinzu.
Syntax
DWORD MprAdminInterfaceTransportAdd(
[in] MPR_SERVER_HANDLE hMprServer,
[in] HANDLE hInterface,
[in] DWORD dwTransportId,
[in] LPBYTE pInterfaceInfo,
[in] DWORD dwInterfaceInfoSize
);
Parameter
[in] hMprServer
Handle für den Router, auf dem Informationen hinzugefügt werden. Rufen Sie dieses Handle ab, indem Sie MprAdminServerConnect aufrufen.
[in] hInterface
Handle für die Schnittstelle, auf der der Transport hinzugefügt wird. Dieses Handle wird durch einen vorherigen Aufruf von MprAdminInterfaceCreate abgerufen.
[in] dwTransportId
Ein DWORD-Wert , der den Transporttyp beschreibt, der der Schnittstelle hinzugefügt werden soll. 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 | Internetpaketaustausch |
| PID_NBF | NetBIOS Frames-Protokoll |
| PID_IPV6 | Windows Server 2008 oder höher: Internetprotokoll, Version 6 |
[in] pInterfaceInfo
Zeiger auf einen Informationsheader, der Schnittstelleninformationen für diesen Transport angibt. Verwenden Sie die Informationsheaderfunktionen , um Informationsheader zu bearbeiten.
[in] dwInterfaceInfoSize
Gibt die Größe der Informationen in Bytes an, auf die von pInterfaceInfo verwiesen wird.
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 |
|---|---|
|
Die aufrufende Anwendung verfügt nicht über ausreichende Berechtigungen. |
|
Der hInterface-Wert ist ungültig. |
|
Der pInterfaceInfo-Parameter ist NULL. |
|
Der dwTransportId-Wert stimmt mit keinem unterstützten Transport überein. |
Hinweise
Der dwTransportId-Parameter gibt auch den Router-Manager an, da ein Router für jeden Transport einen anderen Router-Manager verwendet.
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 |