MappingFreePropertyBag function

Frees memory and resources allocated during an ELS text recognition operation.

Syntax


HRESULT MappingFreePropertyBag(
  _In_ PMAPPING_PROPERTY_BAG pBag
);

Parameters

pBag [in]: Pointer to a MAPPING_PROPERTY_BAG structure containing the properties for which to free resources. This parameter cannot be set to NULL.

Return value

Returns S_OK if successful. The function returns an error HRESULT value if it does not succeed.

Remarks

An ELS service allocates memory and resources for data retrieved from application calls to MappingRecognizeText. The MappingFreePropertyBag function releases these resources.

Caution Services should not be freed before freeing the property bags produced by those services.

Caution The application must call this function only once for each call to MappingRecognizeText when the property bag is no longer needed. Not calling MappingFreePropertyBag after each call to MappingRecognizeText causes a resource leak. For more information about memory allocation for the property bag, see the remarks for the MAPPING_PROPERTY_BAG structure.

Requirements

Minimum supported client	Windows 7 [desktop apps \| Windows Store apps]
Minimum supported server	Windows Server 2008 R2 [desktop apps \| Windows Store apps]
Header	Elscore.h
Library	Elscore.lib
DLL	Elscore.dll