共用方式為

PINTERFACE_STATUS回呼函式 (routprot.h)

  • 發行項

路由器管理員會呼叫 InterfaceStatus 函式來變更介面的狀態。

PINTERFACE_STATUS類型會定義這個回呼函式的指標。 InterfaceStatus 是應用程式定義函數名稱的預留位置。

語法

PINTERFACE_STATUS PinterfaceStatus;

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

參數

[in] InterfaceIndex

指定要變更之介面的索引。

[in] InterfaceActive

指定介面是否為使用中。

[in] StatusType

指定新的介面狀態。 此參數是下列其中一個值。

RIS_INTERFACE_ADDRESS_CHANGE

RIS_INTERFACE_ENABLED

RIS_INTERFACE_DISABLED

RIS_INTERFACE_MEDIA_PRESENT

RIS_INTERFACE_MEDIA_ABSENT

[in] StatusInfo

結構的指標，指定介面狀態類型類型適用的資訊。 例如，如果 StatusType 參數指定位址變更， StatusInfo 參數會指向包含新位址資訊的結構，例如 IP_ADAPTER_BINDING_INFO。 此參數可以是 Null。

傳回值

如果函式成功，則傳回值應該NO_ERROR。

如果函式失敗，傳回值應該是下列其中一個錯誤碼。

值 描述
ERROR_CAN_NOT_COMPLETE
 未指定的失敗。
ERROR_INVALID_PARAMETER
 例如，InterfaceIndex參數無效 (，該索引) 沒有任何介面存在。
 
 

需求

   
最低支援的用戶端 都不支援
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 routprot.h

另請參閱

AddInterface

DeleteInterface