PINTERFACE_STATUS función de devolución de llamada (routprot.h)
El administrador de enrutadores llama a la función InterfaceStatus para cambiar el estado de una interfaz.
El tipo PINTERFACE_STATUS define un puntero a esta función de devolución de llamada. InterfaceStatus es un marcador de posición para el nombre de función definido por la aplicación.
Sintaxis
PINTERFACE_STATUS PinterfaceStatus;
DWORD PinterfaceStatus(
[in] ULONG InterfaceIndex,
[in] BOOL InterfaceActive,
[in] DWORD StatusType,
[in] PVOID StatusInfo
)
{...}
Parámetros
[in] InterfaceIndex
Especifica el índice de la interfaz que se va a cambiar.
[in] InterfaceActive
Especifica si la interfaz está activa.
[in] StatusType
Especifica el nuevo estado de la interfaz. Este parámetro es uno de los siguientes valores.
RIS_INTERFACE_ADDRESS_CHANGE
RIS_INTERFACE_ENABLED
RIS_INTERFACE_DISABLED
RIS_INTERFACE_MEDIA_PRESENT
RIS_INTERFACE_MEDIA_ABSENT
[in] StatusInfo
Puntero a una estructura que especifica la información adecuada para el tipo de tipo de estado de interfaz. Por ejemplo, si el parámetro StatusType especifica un cambio de dirección, el parámetro StatusInfo apunta a una estructura que contiene la nueva información de dirección, como IP_ADAPTER_BINDING_INFO. Este parámetro puede ser NULL.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto debe ser NO_ERROR.
Si se produce un error en la función, el valor devuelto debe ser uno de los siguientes códigos de error.
| Valor | Descripción |
|---|---|
|
Error no especificado. |
|
El parámetro InterfaceIndex no es válido (por ejemplo, no existe ninguna interfaz con ese índice). |
Requisitos
| Cliente mínimo compatible | No se admite ninguno |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | routprot.h |