Método IHolder::AllocResource (comsvcs.h)

Aloca um recurso do inventário.

Sintaxe

HRESULT AllocResource(
  [in]  const RESTYPID __MIDL__IHolder0000,
  [out] RESID          *__MIDL__IHolder0001
);

Parâmetros

[in] __MIDL__IHolder0000

O tipo de recurso a ser alocado.

[out] __MIDL__IHolder0001

Um ponteiro para o local em que o identificador do recurso alocado é retornado.

Valor retornado

Esse método pode retornar os valores a seguir.

Código de retorno	Descrição
S_OK	O método foi concluído com sucesso.
E_INVALIDARG	ResTypId é NULL ou uma cadeia de caracteres vazia ou o método IDispenserDriver::CreateResource do Distribuidor de Recursos gerou um RESID vazio ou duplicado.
E_FAIL	O método falhou. O parâmetro pResId não foi definido. A causa provável é que a transação do chamador esteja anulando.

Comentários

O Gerenciador de Distribuidores executa as seguintes etapas para localizar um recurso:

1. Pesquisa no pool um recurso gratuito desse RESTYPID, que já está inscrito na transação atual do chamador.
2. Pesquisa no pool um recurso não listado gratuito desse RESTYPID e o inscreve na transação atual do chamador.
3. Cria o recurso chamando de volta para o método IDispenserDriver::CreateResource do Distribuidor de Recursos e o inscreve.

Se o chamador não tiver uma transação atual, a inscrição será ignorada. Ou se o Dispensador de Recursos rejeitar a inscrição (o que significa que o recurso não é capaz de transação), a inscrição será ignorada.

Requisitos

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

IDispenserManager

IHolder