cbGetRsvpObjects 関数は、LPM_GETRSVPOBJECTS要求の結果を非同期的に返す LPM のコールバック関数です。 LPM は cbGetRsvpObjects 関数を呼び出して、 LPM_GetRsvpObjects 要求のポリシー データ オブジェクトを PCM に非同期的に返します。 LPM は、PCM のLPM_GetRsvpObjects要求にLPM_RESULTS_DEFER返された場合にのみ cbGetRsvpObjects 関数 を 使用する必要があります。
構文
CBGETRSVPOBJECTS Cbgetrsvpobjects;
ULONG * Cbgetrsvpobjects(
[in] LPM_HANDLE LpmHandle,
[in] RHANDLE RequestHandle,
[in] int LpmError,
[in] int RsvpObjectsCount,
[in] RsvpObjHdr **ppRsvpObjects
)
{...}
パラメーター
[in] LpmHandle
LPM_Initializeで提供されている LPM の一意のハンドル。 PCM は、有効なハンドルを伴わない結果を無視します。
[in] RequestHandle
この要求を、対応するLPM_GetRsvpObjects要求から提供される他のすべての要求と区別する一意 の ハンドル。
[in] LpmError
この関数で返されるポリシー データ オブジェクトを使用する必要があるかどうかを判断するために PCM によって使用されるエラー値。 LPM_OK以外の値を指定すると、PCM は *RsvpObjects の内容を無視します。
LPM がエラーを返している場合は、LPM_GetRsvpObjects要求処理中に割り当てられたバッファーを解放する必要があることに注意してください。これらのバッファーは、LPM_Initialize 関数内で FreeMemory パラメーターとして提供される MemoryAllocator 関数を使用して割り当てる必要があります。
ポリシー データ オブジェクトが返されない場合は、 LpmError をLPM_OKに設定する必要があります。 RsvpObjectsCount は 0 に、*RsvpObjects は null に設定する必要があります。 LPM は、 LpmError の値を LPV_DROP_MSG に設定することで、SBM が RSVP メッセージの送信を停止するように強制できます。
[in] RsvpObjectsCount
返されるポリシー データ オブジェクトの数。 ポリシー データ オブジェクトが返されない場合は、 LpmError パラメーターをLPM_OKに設定する必要があります。 RsvpObjectsCount パラメーターを 0 に設定し、*RsvpObjects パラメーターを null に設定する必要があります。
[in] ppRsvpObjects
ポリシー データ オブジェクトへのポインターの配列。 ポリシー データ オブジェクトを含むバッファーは、LPM_Initialize関数内で提供される MemoryAllocator 関数を使用して割り当てる必要があります。 サブネット帯域幅マネージャー (SBM) は、不要になったときにポリシー データ オブジェクトを解放します。
ポリシー データ オブジェクトが返されない場合は、 LpmError をLPM_OKに設定する必要があります。 RsvpObjectsCount は 0 に、*RsvpObjects は null に設定する必要があります。
戻り値
戻り値は、コールバックを提供するアプリケーションによって定義されます。
注釈
既定のオプションのみが必要な場合、LPM はポリシー データ オプションを送信する必要はありません。 ポリシー データ オブジェクトのコンテンツは PCM に対して不透明であるため、ポリシー要素ヘッダーとコンテンツのホストからネットワークへの順序変換は PCM によって行われません。PCM は、ポリシー要素の受信者が正しく解析できるように、LPM がネットワーク順序でポリシー要素を生成することを想定しています。 ただし、PCM がポリシー要素をマージできるようにするには、ポリシー データ オブジェクト ヘッダーをホストにする必要があります (可能な場合、または該当する場合)。
すべての PE の種類をサポートする LPM から、PCM は完全なポリシー データ オブジェクトとその必要なポリシー データ オプションを必要とします。 さらに、PCM はポリシー データ オブジェクト ヘッダーがホスト順であると想定しています。ポリシー オプションとポリシー要素のホストからネットワークへの順序変換を処理するのは LPM の役割です。
LPM がLPV_DROP_MSGを返した場合、SBM は RSVP 更新メッセージを送信しませんが、他の LPM から返されたポリシー データ オブジェクト (LPV_DROP_MSGを返さなかったオブジェクトがある場合) を解放します。 RSVP 更新メッセージを送信しないことで、アップストリームとダウンストリームの両方のフローの RSVP 状態がエージングし始め、最終的に削除されます。
メモ SBM は、一部またはすべての LPM がポリシー データ オブジェクトをタイムリーに返さない場合でも、RSVP 更新メッセージを送信します。ただし、そのような送信 RSVP メッセージに必要なすべてのポリシー データ オブジェクトが含まれているとは限りません。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | lpmapi.h |