PINTERFACE_STATUS Rückruffunktion (routprot.h)
Der Router-Manager ruft die InterfaceStatus-Funktion auf, um die status einer Schnittstelle zu ändern.
Der PINTERFACE_STATUS Typ definiert einen Zeiger auf diese Rückruffunktion. InterfaceStatus ist ein Platzhalter für den anwendungsdefinierte Funktionsnamen.
Syntax
PINTERFACE_STATUS PinterfaceStatus;
DWORD PinterfaceStatus(
[in] ULONG InterfaceIndex,
[in] BOOL InterfaceActive,
[in] DWORD StatusType,
[in] PVOID StatusInfo
)
{...}
Parameter
[in] InterfaceIndex
Gibt den Index der zu ändernden Schnittstelle an.
[in] InterfaceActive
Gibt an, ob die Schnittstelle aktiv ist.
[in] StatusType
Gibt die neue Schnittstelle status an. Dieser Parameter ist einer der folgenden Werte.
RIS_INTERFACE_ADDRESS_CHANGE
RIS_INTERFACE_ENABLED
RIS_INTERFACE_DISABLED
RIS_INTERFACE_MEDIA_PRESENT
RIS_INTERFACE_MEDIA_ABSENT
[in] StatusInfo
Zeiger auf eine Struktur, die Informationen angibt, die für den Typ der Schnittstelle status Typs geeignet sind. Wenn der StatusType-Parameter beispielsweise eine Adressänderung angibt, verweist der StatusInfo-Parameter auf eine Struktur, die die neuen Adressinformationen enthält, z. B. IP_ADAPTER_BINDING_INFO. Dieser Parameter kann NULL sein.
Rückgabewert
Wenn die Funktion erfolgreich ist, sollte der Rückgabewert NO_ERROR werden.
Wenn die Funktion fehlschlägt, sollte der Rückgabewert einer der folgenden Fehlercodes sein.
| Wert | BESCHREIBUNG |
|---|---|
|
Unspezifizierter Fehler. |
|
Der Parameter InterfaceIndex ist ungültig (z. B. ist mit diesem Index keine Schnittstelle vorhanden). |
Anforderungen
| Unterstützte Mindestversion (Client) | Nicht unterstützt |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | routprot.h |