Metodo IHolder::TrackResource (comsvcs.h)

Tiene traccia della risorsa.

Sintassi

HRESULT TrackResource(
  [in] const RESID __MIDL__IHolder0003
);

Parametri

[in] __MIDL__IHolder0003

Handle della risorsa da tenere traccia. Resource Distributor ha già creato questa risorsa prima di chiamare TrackResource.

Valore restituito

Questo metodo può restituire i valori seguenti.

Commenti

Alcune risorse non vengono mantenute nell'inventario; sono sempre prodotti su richiesta. Il titolare viene usato solo come meccanismo per liberare automaticamente le risorse lasciate alla fine della durata di un oggetto.

TrackResource indica al Titolare che una risorsa deve essere rilevata fino a quando non viene liberata chiamando IHolder::UntrackResource o fino a quando non viene rilasciato l'oggetto denominato TrackResource , in cui il Manager del Distributore libera automaticamente la risorsa.

Se TrackResource viene chiamato da un oggetto transazionale, viene richiamato al metodo IDispenserDriver::EnlistResource di Resource Distributore. Il metodo EnlistResource può integrare la risorsa nella transazione oppure può restituire S_FALSE, a indicare che la risorsa non è in grado di eseguire transazioni e non è stata inserita nell'elenco.

Questa risorsa viene infine eliminata definitivamente dopo che entrambe le operazioni seguenti sono vere:

• Resource Distributor chiama IHolder::UntrackResource (molto probabilmente alla richiesta del componente) o la durata dell'oggetto.
• La transazione in cui è stata inserita la risorsa (se presente) viene eseguita.

Requisiti

Vedi anche

IDispenserDriver

IDispenserManager

IHolder