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、フレーム リレーなど)。 |
|
ダイヤル接続 (アナログ、ISDN、PPTP、切り替え FR) を要求します。 |
|
ローカル ワークステーション接続のみ。 |
|
リモート ワークステーション接続のみ。 |
[in] MediaType
将来使用するために予約されています。
[in] AccessType
将来使用するために予約されています。
[in] ConnectionType
将来使用するために予約されています。
[in] InterfaceInfo
インターフェイスに関連付けられているプロトコル定義の構成情報を指定するバッファーへのポインター。 この情報は、ルーティング プロトコルに対してプライベートです。
[in] StructureVersion
InterfaceInfo パラメーターによって指される情報構造のバージョンを指定します。 場合によっては、これはルーティング プロトコルのバージョンと同じです。
[in] StructureSize
InterfaceInfo パラメーターによって指される各情報構造体のサイズを指定します。 一部の情報構造には可変長メンバーが含まれているので、ルーティング プロトコルは必ずしもバージョンからの情報のサイズを決定できるとは限りません。
[in] StructureCount
InterfaceInfo パラメーターによって指される情報構造体の数を指定します。 このパラメーターは常に 1 つです。
戻り値
関数が成功した場合、戻り値はNO_ERROR。
関数が失敗した場合、戻り値は次のいずれかのエラー コードになります。
| 値 | 説明 |
|---|---|
|
インターフェイスを追加できませんでした。 |
|
InterfaceIndex パラメーターが無効です (たとえば、そのインデックスを持つインターフェイスが既に存在する場合)、または InterfaceInfo が指すパラメーターの 1 つが無効です。 |
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | サポートなし |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | routprot.h |