IHolder::FreeResource method (comsvcs.h)

Article
02/22/2024

Returns a resource to the inventory.

Syntax

HRESULT FreeResource(
  [in] const RESID __MIDL__IHolder0002
);

Parameters

[in] __MIDL__IHolder0002

The handle of the resource to be freed.

Return value

This method can return the following values.

Return code	Description
S_OK	The method completed successfully.
E_INVALIDARG	ResTypId is not a valid resource handle.
E_FAIL	The method failed. The resource has not been freed.

Remarks

A resource originally returned by IHolder::AllocResource is returned to the pool. This notifies the Resource Dispenser through IDispenserDriver::ResetResource, which is the Resource Dispenser's opportunity to prepare the resource before it is returned to the pool.

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	comsvcs.h