CBADMITRESULT 回呼函式 (lpmapi.h)

  • 發行項

cbAdmitResult 函式是由 LPM 用來傳回LPM_AdmitRsvpMsg要求的結果。 如果 LPM 已傳回LPM_RESULT_DEFER給 LPM_AdmitRsvpMsg 函數調用，則應該只使用此函式。 PCM 只會在透過 LPM_Initialize 函式的 ResultTimeLimit 參數所建立的每個 LPM 所建立的結果時間限制內接受此函式的結果。

語法

CBADMITRESULT Cbadmitresult;

ULONG * Cbadmitresult(
  [in] LPM_HANDLE LpmHandle,
  [in] RHANDLE RequestHandle,
  [in] ULONG ulPcmActionFlags,
  [in] int LpmError,
  [in] int PolicyDecisionsCount,
  [in] POLICY_DECISION *pPolicyDecisions
)
{...}

參數

[in] LpmHandle

LPM 的唯一句柄，如 LPM_Initialize中提供。 PCM 會忽略任何未伴隨有效 LPM 句柄的結果。

[in] RequestHandle

區分此要求與所有其他要求的唯一句柄。 呼叫 cbAdmitResult 以異步方式傳回個別要求的結果時，LPM 必須將此句柄傳遞至 PCM。 一旦傳回結果， RequestHandle 參數就會變成無效，要求每個要求從 PCM 取得自己的唯一 RequestHandle 。

[in] ulPcmActionFlags

原則控制模組動作旗標。

[in] LpmError

LPM 錯誤碼。 必須是下列其中之一：

值 意義
INV_LPM_HANDLE
 提供的 LPM 句柄無效。
LPM_TIME_OUT
 LPM 在時間限制之後傳回結果。
INV_REQ_HANDLE
 提供的要求句柄無效。
DUP_RESULTS
 LPM 已傳回此要求的結果。
INV_RESULTS
 提供的結果無效。

[in] PolicyDecisionsCount

pPolicyDecisions 中提供的原則決策數目。

[in] pPolicyDecisions

原則決策，格式為一或多個 POLICY_DECISION 結構。

傳回值

這個回呼函式不會傳回值。

備註

當要求遭到拒絕時，PCM 會呼叫 LPM 以指示它刪除要求的狀態。 LPM 可以選擇在拒絕程式期間隨時刪除要求的狀態。 如果 LPM 在要求拒絕之後不久刪除要求的狀態，則必須準備 LPM 來處理 PCM 的後續呼叫 (，方法是透過 LPM_DeleteState 函式) 刪除已刪除的 () 狀態。

LPM 不需要維護其傳回LPV_DONT_CARE要求的狀態。 不過，LPM 必須準備好處理此 (不存在) 狀態的LPM_DeleteState要求。

規格需求

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

另請參閱

LPM_AdmitRsvpMsg

LPM_DeleteState

LPM_Initialize