Compartilhar via

Método IDispenserDriver::RateResource (comsvcs.h)

  • Artigo

Avalia o quão bem um recurso candidato corresponde.

Sintaxe

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

Parâmetros

[in] ResTypId

O tipo de recurso que o Gerenciador de Distribuidores está procurando corresponder.

[in] ResId

O recurso candidato que o Gerenciador de Dispensa está considerando.

[in] fRequiresTransactionEnlistment

Se TRUE, o recurso candidato (ResId), se escolhido, exigirá inscrição de transação. Se a inscrição for cara, RateResource poderá classificar esse recurso mais baixo do que um recurso que já está inscrito na transação correta.

[out] pRating

A classificação do Dispenser deste candidato. Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
0
 O recurso candidato é inutilizável para essa solicitação. O recurso não é ou não pode ser alterado para ser do tipo ResTypId.
1
 O candidato é um ajuste ruim, mas utilizável. O Gerenciador de Distribuidores continuará a sugerir candidatos.
2
 O candidato é melhor do que os candidatos classificados como 1. O Gerenciador de Distribuidores continuará a sugerir candidatos.
100
 O candidato é perfeito. O Gerente do Distribuidor deixará de sugerir candidatos.

Retornar valor

Se o método for bem-sucedido, o valor retornado será S_OK. Caso contrário, será E_FAIL.

Comentários

Se fRequiresTransactionEnlistment for FALSE, um objeto foi dispensado desse recurso nessa transação, o objeto usado e, em seguida, liberou o recurso (explicitamente ou implicitamente no final do tempo de vida do objeto). Um segundo objeto na mesma transação solicita um recurso semelhante e o recurso usado pelo primeiro objeto é considerado. Esse recurso é um bom candidato porque ele já está inscrito na transação correta.

Se um tipo específico de recurso puder ser usado apenas uma vez por transação, um recurso que já foi usado uma vez na transação poderá ser identificado por um fRequiresTransactionEnlistment de FALSE e poderá ser rejeitado para uso adicional retornando *pRating=0.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho comsvcs.h

Confira também

IDispenserDriver