IMcastLeaseInfo

IMcastLeaseInfo インターフェイスは、マルチキャストアドレスの割り当てに関する情報を取得または設定できるメソッドを公開します。IMcastLease オブジェクトは、IMcastAddressAllocation::CreateLeaseInfo を呼び出すことで作成されます。

get_RequestID メソッドは、リースの要求 ID を取得します。

このメソッドは、次のいずれかの値を返すことがあります。

アプリケーションは、ppRequestID パラメーターに割り当てられたメモリを解放するために SysFreeString を使用する必要があります。

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

get_LeaseStartTime メソッドは、リースの開始時刻を取得します。

このメソッドは、次のいずれかの値を返すことがあります。

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

put_LeaseStartTime メソッドは、リースの開始時刻を設定します。このメソッドは、put_LeaseStopTime と組み合わせることで、IMcastAddressAllocation::CreateLeaseInfo を呼び出すことなくリースを更新できます。

このメソッドは、次のいずれかの値を返すことがあります。

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

get_LeaseStopTime メソッドは、リースの終了時刻を取得します。

このメソッドは、次のいずれかの値を返すことがあります。

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

put_LeaseStopTime メソッドは、リースの終了時刻を設定します。このメソッドは、put_LeaseStartTime と組み合わせることで、IMcastAddressAllocation::CreateLeaseInfo を呼び出すことなくリースを更新できます。

このメソッドは、次のいずれかの値を返すことがあります。

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

get_AddressCount メソッドは、このリースで要求または付与されたアドレスの数を取得します。

このメソッドは、次のいずれかの値を返すことがあります。

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

get_ServerAddress メソッドは、このリースを付与するマルチキャストサーバーのアドレスを表す文字列を取得します。

このメソッドは、次のいずれかの値を返すことがあります。

BSTR 文字列 ppAddress は、ドット区切りの 4 組表記による IP バージョン 4 アドレスです (例: 10.111.222.111)。リース情報オブジェクトが付与済みのリースを表していない場合 (たとえば、 IMcastAddressAllocation::RequestAddress または IMcastAddressAllocation::RenewAddress によって返されたものではない場合)、アドレスは文字列 "Unspecified" として報告されます。

アプリケーションは、ppAddress パラメーターに割り当てられたメモリを解放するために SysFreeString を使用する必要があります。

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

get_TTL メソッドは、このリースに関連付けられた TTL (Time To Live) 値を取得します。

このメソッドは、次のいずれかの値を返すことがあります。

TTL は、マルチキャストルーティングの実装において多かれ少なかれ重要な意味を持ちます。一般に、TTL 値が大きいほど、マルチキャストスコープは "広く"、より包括的になります。ほとんどのアプリケーションでは、TTL を扱う必要はありません。

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

get_Addresses メソッドは、このリースまたはリース要求の対象であるマルチキャストアドレスのコレクションを取得します。このメソッドは主に Visual Basic やその他のスクリプト言語向けです。C++ プログラマーは代わりに EnumerateAddresses を使用します。

このメソッドは、次のいずれかの値を返すことがあります。

各アドレスは、ドット区切りの 4 組表記で BSTR として表される IP バージョン 4 アドレスです (例: 10.111.222.111)。

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

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

EnumerateAddresses メソッドは、このリースまたはリース要求の対象であるマルチキャストアドレスのコレクションを取得します。このメソッドは主に C++ プログラマー向けです。Visual Basic やその他のスクリプト言語は代わりに get_Addresses を使用します。

このメソッドは、次のいずれかの値を返すことがあります。

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