共用方式為

PADD_INTERFACE回呼函式 (routprot.h)

  • 發行項

AddInterface 函式會新增要由路由通訊協定管理的介面。 通訊協議應該將介面視為處於停用狀態。 路由器管理員會使用 RIS_INTERFACE_ENABLED 旗標呼叫 InterfaceStatus 來啟用介面。

當使用者呼叫 MprAdminInterfaceTransportAdd 時，傳輸的動態介面管理員會呼叫路由器管理員 (傳輸) ，這會針對與該傳輸相關聯的每個路由通訊協定呼叫此函式。

語法

PADD_INTERFACE PaddInterface;

DWORD PaddInterface(
  [in] LPWSTR InterfaceName,
  [in] ULONG InterfaceIndex,
  [in] NET_INTERFACE_TYPE InterfaceType,
  [in] DWORD MediaType,
  [in] WORD AccessType,
  [in] WORD ConnectionType,
  [in] PVOID InterfaceInfo,
  [in] ULONG StructureVersion,
  [in] ULONG StructureSize,
  [in] ULONG StructureCount
)
{...}

參數

[in] InterfaceName

Unicode 字串的指標。 字串包含名稱，可唯一識別路由器上所設定介面集合中的介面。

[in] InterfaceIndex

指定路由器上所設定介面集合中的介面。

[in] InterfaceType

指定介面的類型。

值 意義
永久
 例如 LAN、Frame Relay) 等永久連線 (。
DEMAND_DIAL
 需求撥號連線能力 (類比、ISDN、PPTP、切換的FR) 。
LOCAL_WORKSTATION_DIAL
 僅限本機工作站連線能力。
REMOTE_WORKSTATION_DIAL
 僅限遠端工作站連線能力。

[in] MediaType

保留供未來使用。

[in] AccessType

保留供未來使用。

[in] ConnectionType

保留供未來使用。

[in] InterfaceInfo

緩衝區的指標，指定與 介面相關聯的通訊協定定義組態資訊。 此資訊是路由通訊協定的私人資訊。

[in] StructureVersion

指定 InterfaceInfo 參數所指向的信息結構版本。 在某些情況下，這等於路由通訊協定的版本。

[in] StructureSize

指定 InterfaceInfo 參數所指向之每個資訊結構的大小。 由於某些資訊結構包含可變長度成員，因此路由通訊協定不一定能夠判斷版本的資訊大小。

[in] StructureCount

指定 InterfaceInfo 參數所指向的信息結構數目計數。 此參數一律為一個。

傳回值

如果函式成功，傳回值會NO_ERROR。

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

值 Description
ERROR_CAN_NOT_COMPLETE
 嘗試新增介面失敗。
ERROR_INVALID_PARAMETER
 例如，InterfaceIndex 參數無效 (，該索引的介面已經存在) ，或 InterfaceInfo 所指向的其中一個參數無效。
 
 

規格需求

需求 值
最低支援的用戶端 都不支援
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 routprot.h

另請參閱

DeleteInterface

路由通訊協定介面函式

路由通訊協定介面參考