MprAdminInterfaceQueryUpdateResult-Funktion (mprapi.h)

Die Funktion MprAdminInterfaceQueryUpdateResult gibt das Ergebnis der letzten Anforderung an einen angegebenen Router-Manager zurück, um dessen Routen für eine Schnittstelle zu aktualisieren. Weitere Informationen finden Sie unter MprAdminInterfaceUpdateRoutes.

Syntax

DWORD MprAdminInterfaceQueryUpdateResult(
  [in]  MPR_SERVER_HANDLE hMprServer,
  [in]  HANDLE            hInterface,
  [in]  DWORD             dwProtocolId,
  [out] LPDWORD           lpdwUpdateResult
);

Parameter

[in] hMprServer

Handle an den Router, von dem Informationen abgerufen werden. Rufen Sie dieses Handle ab, indem Sie MprAdminServerConnect aufrufen.

[in] hInterface

Handle für die -Schnittstelle. Dieses Handle wird aus einem vorherigen Aufruf von MprAdminInterfaceCreate abgerufen.

[in] dwProtocolId

Ein DWORD-Wert , der angibt, welcher Router-Manager abgefragt wird. Der Router verwendet für jedes Transportprotokoll einen anderen Router-Manager. 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] lpdwUpdateResult

Zeiger auf eine DWORD-Variable . Diese Variable empfängt das Ergebnis des letzten Aufrufs von MprAdminInterfaceUpdateRoutes.

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_ACCESS_DENIED	Die aufrufende Anwendung verfügt nicht über ausreichende Berechtigungen.
ERROR_INTERFACE_NOT_CONNECTED	Die angegebene Schnittstelle ist nicht verbunden. das Ergebnis der letzten Aktualisierung ist nicht mehr verfügbar.
ERROR_INVALID_HANDLE	Der hInterface-Wert ist ungültig.
ERROR_INVALID_PARAMETER	Der lpdwUpdateResult-Parameter ist NULL.
ERROR_NO_SUCH_INTERFACE	Der angegebene Transport wird auf der angegebenen Schnittstelle nicht ausgeführt.
ERROR_UNKNOWN_PROTOCOL_ID	Der DwProtocolId-Wert stimmt mit keinem unterstützten Router-Manager überein.

Hinweise

Der dwProtocolId-Parameter gibt sowohl einen Transport als auch einen Router-Manager an, da der Router einen Router-Manager für jeden Transport verwaltet.

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

MprAdminInterfaceErstellen

MprAdminInterfaceUpdateRoutes

MprAdminServerConnect

Routerverwaltungsfunktionen

Referenz zur Routerverwaltung