IMcastAddressAllocation

IMcastAddressAllocation は、マルチキャストアドレス割り当てのためのメインインターフェイスです。アプリケーションはこのインターフェイスに対して COM の CoCreateInstance 関数を呼び出し、マルチキャストクライアントインターフェイスオブジェクトを作成します。

マルチキャスト COM インターフェイスは、マルチキャストアドレスのリースを割り当て、更新し、解放するためのネットワーク機能へのアクセスを提供します。これらは一連の関数定義とデータ構造定義をカプセル化します。COM インターフェイスにより、プログラマーはこれらのデータ構造を理解し操作するという負担から解放されます。さらに、TAPI 3 自体が COM ベースであるため、これらのインターフェイスは TAPI 3 が提供する他の機能と一貫した形でマルチキャストアドレス割り当てを利用できるようにします。Visual Basic、Java、またはスクリプト言語で記述されたアプリケーションは、これらの COM インターフェイスを使用する必要があります。通常は Windows API に直接アクセスできないためです。

さらに、このコンポーネントは、非マルチキャスト環境向けにローカルアドレス割り当てのシームレスで透過的なサポートを提供します。DWORD レジストリ値 HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\MCAST\LocalAllocation をゼロ以外の値に設定すると、すべてのマルチキャストアドレスの割り当てにローカルマシン上で行われる乱数生成を使用することを指定します。これにより、マルチキャストアドレス割り当てサーバーが存在しないネットワーク上でも、マルチキャストアドレス割り当てサーバーが存在するネットワーク上と同じようにアプリケーションが動作できるようになります。このレジストリ値がゼロに設定されているか存在しない場合、このコンポーネントは本仕様の残りの部分で説明するとおり通常どおり動作します。なお、このレジストリキーがゼロ以外の値に設定されていない限り、ローカルアドレス割り当ては決して使用されません。ローカルアドレス割り当ては、一時的にアクセスできないマルチキャストアドレス割り当てサーバーのフォールバック機構ではありません。

マルチキャストアドレス割り当ては現在 IETF ワーキンググループで検討中の課題です。最新情報にアクセスするには、任意のインターネット検索エンジンで「Internet draft」および「MDHCP」または「MADCAP」を検索してください。MADCAP(以前は MDHCP と呼ばれていました)に加えて、提案されているアーキテクチャには、ドメインまたは AS 内でのサーバー間協調のためのプロトコルや、ドメイン間協調のためのプロトコルが含まれます。このアーキテクチャは現在も進化を続けていますが、クライアントがこの仕組みの詳細に関与する必要はありません。

このコンポーネントは現在、IP バージョン 4 のアドレスのみをサポートしています。

get_Scopes メソッドは、利用可能な IMcast スコープのコレクションを作成します。このメソッドは EnumerateScopes に似ていますが、Visual Basic などのスクリプト言語で使用されます。

このメソッドは次のいずれかの値を返します。

TAPI は IMcastAddressAllocation::get_Scopes が返す IMcastScope インターフェイスに対して AddRef メソッドを呼び出します。アプリケーションは、それに関連付けられたリソースを解放するために IMcastScope インターフェイスに対して Release を呼び出す必要があります。

EnumerateScopes メソッドは、利用可能なマルチキャストスコープの列挙を作成します。このメソッドは主に C++ プログラマー向けです。Visual Basic やその他のスクリプト言語では代わりに get_Scopes を使用します。

このメソッドは次のいずれかの値を返します。

TAPI は IMcastAddressAllocation::EnumerateScopes が返す IEnumMcastScope インターフェイスに対して AddRef メソッドを呼び出します。アプリケーションは、それに関連付けられたリソースを解放するために IEnumMcastScope インターフェイスに対して Release を呼び出す必要があります。

RequestAddress メソッドは、1 つ以上のマルチキャストアドレスに対する新しいリースを取得します。事前に EnumerateScopes または get_Scopes メソッドを呼び出しておく必要があります。

このメソッドは次のいずれかの値を返します。

これらの COM インターフェイスとその実装は複数アドレスの一括割り当てをサポートしていますが、その基盤となる関数呼び出しは現在のところ複数割り当てをサポートしていません。複数アドレスの割り当てにはループを使用する必要がある場合があります。

TAPI は IMcastAddressAllocation::RequestAddress が返す IMcastLeaseInfo インターフェイスに対して AddRef メソッドを呼び出します。アプリケーションは、それに関連付けられたリソースを解放するために IMcastLeaseInfo インターフェイスに対して Release を呼び出す必要があります。

RenewAddress メソッドは、アドレスリースを更新します。CreateLeaseInfo を呼び出して更新要求のパラメーターを指定し、その後にこのメソッドを呼び出して要求を行います。

このメソッドは次のいずれかの値を返します。

ReleaseAddress メソッドは、以前に取得したリースを解放します。

このメソッドは次のいずれかの値を返します。

CreateLeaseInfo メソッドは、後続の RenewAddress または ReleaseAddress の呼び出しのためにリース情報オブジェクトを作成します。

このメソッドは次のいずれかの値を返します。

TAPI は IMcastAddressAllocation::CreateLeaseInfo が返す IMcastLeaseInfo インターフェイスに対して AddRef メソッドを呼び出します。アプリケーションは、それに関連付けられたリソースを解放するために IMcastLeaseInfo インターフェイスに対して Release を呼び出す必要があります。

この関数はデータを暗号化されていない形式でネットワーク上に送信する場合があります。そのため、ネットワークを盗聴している者がデータを読み取れる可能性があります。このメソッドを使用する前に、データを平文で送信することのセキュリティリスクを考慮する必要があります。

CreateLeaseInfoFromVariant メソッドは、後続の RenewAddress または ReleaseAddress の呼び出しのためにリース情報オブジェクトを作成します。このメソッドは CreateLeaseInfo に似ていますが、Visual Basic などの Automation クライアント言語で使用されます。

このメソッドは次のいずれかの値を返します。

アプリケーションは、pRequestID および pServerAddress パラメーターのメモリを割り当てるために SysAllocString を使用する必要があります。アプリケーションは、これらの変数が不要になったときにメモリを解放するために SysFreeString を使用する必要があります。

TAPI は IMcastAddressAllocation::CreateLeaseInfoFromVariant が返す IMcastLeaseInfo インターフェイスに対して AddRef メソッドを呼び出します。アプリケーションは、それに関連付けられたリソースを解放するために IMcastLeaseInfo インターフェイスに対して Release を呼び出す必要があります。

この関数はデータを暗号化されていない形式でネットワーク上に送信する場合があります。そのため、ネットワークを盗聴している者がデータを読み取れる可能性があります。このメソッドを使用する前に、データを平文で送信することのセキュリティリスクを考慮する必要があります。