MprAdminInterfaceTransportGetInfo-Funktion (mprapi.h)
Die Funktion MprAdminInterfaceTransportGetInfo ruft Informationen zu einem Transport ab, der auf einer angegebenen Schnittstelle ausgeführt wird.
Syntax
DWORD MprAdminInterfaceTransportGetInfo(
[in] MPR_SERVER_HANDLE hMprServer,
[in] HANDLE hInterface,
[in] DWORD dwTransportId,
[out] LPBYTE *ppInterfaceInfo,
[out, optional] LPDWORD lpdwInterfaceInfoSize
);
Parameter
[in] hMprServer
Verarbeiten Sie den Router, von dem Informationen abgerufen werden. Rufen Sie dieses Handle ab, indem Sie MprAdminServerConnect aufrufen.
[in] hInterface
Handle mit der Schnittstelle. Dieses Handle wird aus einem vorherigen Aufruf von MprAdminInterfaceCreate abgerufen.
[in] dwTransportId
Ein DWORD-Wert , der den Transport beschreibt, für den Informationen angefordert werden. 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 |
[out] ppInterfaceInfo
Zeiger auf eine Zeigervariable. Die Zeigervariable zeigt auf einen Informationsheader, der Informationen für die angegebene Schnittstelle und den angegebenen Transport empfängt. Verwenden Sie die Informationsheaderfunktionen , um Informationsheader zu bearbeiten. Geben Sie diesen Arbeitsspeicher frei, indem Sie MprAdminBufferFree aufrufen.
[out, optional] lpdwInterfaceInfoSize
Zeiger auf eine DWORD-Variable . Diese Variable empfängt die Größe der Schnittstelleninformationen, die über den ppInterfaceInfo-Parameter zurückgegeben werden, in Bytes.
Dieser Parameter ist optional. Wenn die aufrufende Anwendung NULL für diesen Parameter angibt, gibt die Funktion die Größe der Schnittstelleninformationen nicht zurück.
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, oder wenn die angegebene Schnittstelle administrativ deaktiviert ist. |
|
Der angegebene Transport wird nicht auf der angegebenen Schnittstelle ausgeführt. |
|
Unzureichende Ressourcen, um den Vorgang abzuschließen. |
|
Der wert dwTransportId stimmt mit keinem unterstützten Transport überein. |
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 |