Funzione MprAdminInterfaceQueryUpdateResult (mprapi.h)

Articolo
03/13/2024

La funzione MprAdminInterfaceQueryUpdateResult restituisce il risultato dell'ultima richiesta a un gestore router specificato per aggiornare le route per un'interfaccia. Per altre informazioni, vedere MprAdminInterfaceUpdateRoutes.

Sintassi

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

Parametri

[in] hMprServer

Handle al router da cui vengono recuperate le informazioni. Ottenere questo handle chiamando MprAdminServerConnect.

[in] hInterface

Handle per l'interfaccia. Questo handle viene ottenuto da una chiamata precedente a MprAdminInterfaceCreate.

[in] dwProtocolId

Valore DWORD che specifica la gestione router su cui viene eseguita una query. Il router usa un gestore router diverso per ogni protocollo di trasporto. I valori accettabili per dwTransportId sono elencati nella tabella seguente.

Valore	Trasporto (famiglia di protocolli)
PID_ATALK	Appletalk
PID_IP	Protocollo Internet versione 4
PID_IPX	Scambio di pacchetti Internet
PID_NBF	Protocollo NetBIOS Frames
PID_IPV6	Windows Server 2008 o versione successiva: Protocollo Internet versione 6

[out] lpdwUpdateResult

Puntatore a una variabile DWORD . Questa variabile riceve il risultato dell'ultima chiamata a MprAdminInterfaceUpdateRoutes.

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene NO_ERROR.

Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti.

Valore	Significato
ERROR_ACCESS_DENIED	L'applicazione chiamante non dispone di privilegi sufficienti.
ERROR_INTERFACE_NOT_CONNECTED	L'interfaccia specificata non è connessa; il risultato dell'ultimo aggiornamento non è più disponibile.
ERROR_INVALID_HANDLE	Il valore hInterface non è valido.
ERROR_INVALID_PARAMETER	Il parametro lpdwUpdateResult è NULL.
ERROR_NO_SUCH_INTERFACE	Il trasporto specificato non è in esecuzione nell'interfaccia specificata.
ERROR_UNKNOWN_PROTOCOL_ID	Il valore dwProtocolId non corrisponde ad alcun gestore router supportato.

Commenti

Il parametro dwProtocolId specifica sia un trasporto che una gestione router, poiché il router gestisce un gestore router per ogni trasporto.

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	mprapi.h
Libreria	Mprapi.lib
DLL	Mprapi.dll

Vedi anche

MprAdminInterfaceCreate

MprAdminInterfaceUpdateRoutes

MprAdminServerConnect

Funzioni di amministrazione router

Informazioni di riferimento sulla gestione dei router

Condividi tramite