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 |
---|---|
|
O método foi concluído com sucesso. |
|
ResTypId é NULL ou uma cadeia de caracteres vazia ou o método IDispenserDriver::CreateResource do Distribuidor de Recursos gerou um RESID vazio ou duplicado. |
|
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:
- Pesquisa no pool um recurso gratuito desse RESTYPID, que já está inscrito na transação atual do chamador.
- Pesquisa no pool um recurso não listado gratuito desse RESTYPID e o inscreve na transação atual do chamador.
- Cria o recurso chamando de volta para o método IDispenserDriver::CreateResource do Distribuidor de Recursos e o inscreve.
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 |