Funzione MprAdminInterfaceUpdateRoutes (mprapi.h)

Articolo
02/29/2024

La funzione MprAdminInterfaceUpdateRoutes richiede a una gestione router specificata di aggiornare le informazioni di routing per un'interfaccia specificata.

Sintassi

DWORD MprAdminInterfaceUpdateRoutes(
  [in] MPR_SERVER_HANDLE hMprServer,
  [in] HANDLE            hInterface,
  [in] DWORD             dwProtocolId,
  [in] HANDLE            hEvent
);

Parametri

[in] hMprServer

Gestire il router in cui vengono aggiornate le informazioni. Ottenere questo handle chiamando MprAdminServerConnect.

[in] hInterface

Gestire l'interfaccia da aggiornare. Ottenere questo handle chiamando MprAdminInterfaceCreate.

[in] dwProtocolId

Valore DWORD che specifica quale gestore router aggiorna le informazioni di routing. 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	Internet Protocol versione 4
PID_IPX	Scambio pacchetti Internet
PID_NBF	Protocollo Frame NetBIOS
PID_IPV6	Windows Server 2008 o versione successiva: Protocollo Internet versione 6

[in] hEvent

Gestire un evento segnalato quando il tentativo di aggiornare le informazioni di routing per l'interfaccia specificata è stato completato. Se NULL, la funzione è sincrona. L'applicazione chiamante deve specificare NULL per questo parametro, se hMprServer specifica un router remoto.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è 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. Pertanto, le route non possono essere aggiornate.
ERROR_INVALID_HANDLE	Il valore hInterface non è valido.
ERROR_NO_SUCH_INTERFACE	Il trasporto specificato non è in esecuzione nell'interfaccia specificata.
ERROR_UNKNOWN_PROTOCOL_ID	Il valore dwTransportId non corrisponde a nessuno dei gestori del router.
ERROR_UPDATE_IN_PROGRESS	Un'operazione di aggiornamento delle informazioni di routing è già in corso su questa interfaccia.
IN SOSPESO	L'interfaccia si trova nel processo di aggiornamento delle informazioni di routing. L'applicazione chiamante deve attendere l'oggetto evento specificato da hEvent. Dopo aver segnalato l'evento, lo stato dell'operazione di aggiornamento può essere ottenuto chiamando MprAdminInterfaceQueryUpdateResult.

Commenti

Il parametro dwTransportId specifica sia un protocollo di trasporto che un gestore router univoco perché il router usa una gestione router diversa 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

MprAdminInterfaceQueryUpdateResult

MprAdminServerConnect

Funzioni di amministrazione del router

Informazioni di riferimento sulla gestione dei router

Condividi tramite