funzione di callback PINTERFACE_STATUS (routprot.h)

Articolo
03/15/2023

Gestione router chiama la funzione InterfaceStatus per modificare lo stato di un'interfaccia.

Il tipo PINTERFACE_STATUS definisce un puntatore a questa funzione di callback. InterfaceStatus è un segnaposto per il nome della funzione definita dall'applicazione.

Sintassi

PINTERFACE_STATUS PinterfaceStatus;

DWORD PinterfaceStatus(
  [in] ULONG InterfaceIndex,
  [in] BOOL InterfaceActive,
  [in] DWORD StatusType,
  [in] PVOID StatusInfo
)
{...}

Parametri

[in] InterfaceIndex

Specifica l'indice dell'interfaccia da modificare.

[in] InterfaceActive

Specifica se l'interfaccia è attiva.

[in] StatusType

Specifica lo stato della nuova interfaccia. Questo parametro è uno dei valori seguenti.

RIS_INTERFACE_ADDRESS_CHANGE

RIS_INTERFACE_ENABLED

RIS_INTERFACE_DISABLED

RIS_INTERFACE_MEDIA_PRESENT

RIS_INTERFACE_MEDIA_ABSENT

[in] StatusInfo

Puntatore a una struttura che specifica le informazioni appropriate per il tipo di tipo di stato dell'interfaccia. Ad esempio, se il parametro StatusType specifica una modifica dell'indirizzo, il parametro StatusInfo punta a una struttura che contiene le nuove informazioni sull'indirizzo, ad esempio IP_ADAPTER_BINDING_INFO. Questo parametro può essere NULL.

Valore restituito

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

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

Valore	Descrizione
ERROR_CAN_NOT_COMPLETE	Errore non specificato.
ERROR_INVALID_PARAMETER	Il parametro InterfaceIndex non è valido( ad esempio, nessuna interfaccia esiste con tale indice).

Requisiti


Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	routprot.h

Vedi anche

AddInterface

DeleteInterface

Condividi tramite