通过

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。

言论

如果 fRequiresTransactionEnlistmentFALSE，则会在此事务中分配此资源，该对象使用并释放资源（在对象生存期结束时显式或隐式释放）。 同一事务中的第二个对象要求使用类似的资源，并考虑第一个对象使用的资源。 此资源是一个很好的候选资源，因为它已在正确的事务中登记。

如果每个事务只能使用一次特定类型的资源，则事务中已使用过一次的资源可以通过 fRequiresTransactionEnlistmentFALSE 标识，并且可以通过返回 *pRating=0 来拒绝进一步使用。

要求

要求 价值
最低支持的客户端 Windows 2000 Professional [仅限桌面应用]
支持的最低服务器 Windows 2000 Server [仅限桌面应用]
目标平台 窗户
标头 comsvcs.h

另请参阅

IDispenserDriver