Share via

IDispenserDriver：：RateResource 方法 (comsvcs.h)

  • 發行項

評估候選資源相符程度。

語法

HRESULT RateResource(
  [in]  const RESTYPID ResTypId,
  [in]  const RESID    ResId,
  [in]  const BOOL     fRequiresTransactionEnlistment,
  [out] RESOURCERATING *pRating
);

參數

[in] ResTypId

分配器管理員想要比對的資源類型。

[in] ResId

分配器管理員正在考慮的候選資源。

[in] fRequiresTransactionEnlistment

如果 為 TRUE，則候選資源 (ResId) ，如果已選擇，則需要交易登記。 如果登記成本很高， RateResource 可能會將這類資源評分低於已在正確交易中登記的資源。

[out] pRating

此候選專案的分配器評等。 此參數可以是下列其中一個值。

值 意義
0
 此要求無法使用候選資源。 資源不是或無法變更為 ResTypId 類型。
1
 候選項目很適合，但可用。 分配器管理員會繼續建議候選專案。
2
 候選專案優於評等為1的候選專案。 分配器管理員會繼續建議候選專案。
100
 候選專案非常適合。 分配器管理員會停止建議候選專案。

傳回值

如果方法成功，傳回值會S_OK。 否則會E_FAIL。

備註

如果 fRequiresTransactionEnlistment 為 FALSE，則會在此交易中分配此 (資源，然後使用的物件，然後在物件存留期結束時明確或隱含釋放資源) 。 相同交易中的第二個物件會要求類似的資源，並考慮第一個物件所使用的資源。 此資源是很好的候選項目，因為它已在正確的交易中登記。

如果每個交易只能使用一次特定的資源類型，則交易中已經使用過一次的資源可由 FALSE 的 fRequiresTransactionEnlistment 來識別，而且可以傳回 *pRating=0 來拒絕進一步使用。

規格需求

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

另請參閱

IDispenserDriver