PINTERFACE_STATUS fonction de rappel (routprot.h)

Article
08/25/2023

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

Partager via