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

  • Artículo

Asigna un recurso del inventario.

Sintaxis

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

Parámetros

[in] __MIDL__IHolder0000

Tipo de recurso que se va a asignar.

[out] __MIDL__IHolder0001

Puntero a la ubicación donde se devuelve el identificador del recurso asignado.

Valor devuelto

Este método puede devolver los valores siguientes.

Código devuelto Descripción
S_OK
 El método se completó correctamente.
E_INVALIDARG
 ResTypId es NULL o una cadena vacía, o el método IDispenserDriver::CreateResource del dispensador de recursos generó un RESID vacío o duplicado.
E_FAIL
Error en el método. No se ha establecido el parámetro pResId . La causa probable es que se anule la transacción del autor de la llamada.

Comentarios

El Administrador de dispensadores realiza los pasos siguientes para localizar un recurso:

  1. Busca en el grupo un recurso gratuito de este RESTYPID, que ya está inscrito en la transacción actual del autor de la llamada.
  2. Busca en el grupo un recurso no registrado gratuito de este RESTYPID y, a continuación, lo inscribe en la transacción actual del autor de la llamada.
  3. Crea el recurso llamando de nuevo al método IDispenserDriver::CreateResource del dispensador de recursos y, a continuación, lo inscribe.
Si el autor de la llamada no tiene una transacción actual, se omite la inscripción. O bien, si el dispensador de recursos rechaza la inscripción (lo que significa que el recurso no es capaz de transacciones), se omite la inscripción.

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado comsvcs.h

Consulte también

IDispenserDriver

IDispenserManager

IHolder