Partager via


PINTERFACE_STATUS fonction de rappel (routprot.h)

Le gestionnaire de routeur appelle la fonction InterfaceStatus pour modifier la status d’une interface.

Le type PINTERFACE_STATUS définit un pointeur vers cette fonction de rappel. InterfaceStatus est un espace réservé pour le nom de fonction défini par l’application.

Syntaxe

PINTERFACE_STATUS PinterfaceStatus;

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

Paramètres

[in] InterfaceIndex

Spécifie l’index de l’interface à modifier.

[in] InterfaceActive

Spécifie si l’interface est active.

[in] StatusType

Spécifie la nouvelle status d’interface. Ce paramètre est l’une des valeurs suivantes.

RIS_INTERFACE_ADDRESS_CHANGE

RIS_INTERFACE_ENABLED

RIS_INTERFACE_DISABLED

RIS_INTERFACE_MEDIA_PRESENT

RIS_INTERFACE_MEDIA_ABSENT

[in] StatusInfo

Pointeur vers une structure qui spécifie des informations appropriées au type d’interface status type. Par exemple, si le paramètre StatusType spécifie un changement d’adresse, le paramètre StatusInfo pointe vers une structure qui contient les nouvelles informations d’adresse, telles que IP_ADAPTER_BINDING_INFO. Ce paramètre peut avoir la valeur NULL.

Valeur retournée

Si la fonction réussit, la valeur de retour doit être NO_ERROR.

Si la fonction échoue, la valeur de retour doit être l’un des codes d’erreur suivants.

Valeur Description
ERROR_CAN_NOT_COMPLETE
Défaillance non spécifiée.
ERROR_INVALID_PARAMETER
Le paramètre InterfaceIndex n’est pas valide (par exemple, il n’existe aucune interface avec cet index).
 
 

Spécifications

   
Client minimal pris en charge Aucun pris en charge
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête routprot.h

Voir aussi

AddInterface

DeleteInterface