4.12 WFSFreeResult

HRESULT WFSFreeResult ( lpResult )

Notifies the XFS Manager that a memory buffer (or linked list of buffers) that was dynamically allocated by a service provider is to be freed.

Parameters LPWFSRESULT lpResult

Pointer to a WFSRESULT data structure.

Mode Immediate

Comments The WOSA/XFS service providers may allocate memory to send data to an application. This function is used by the application to deallocate the memory, and the application must call it when it no longer needs access to the memory. When the applications calls WFSFreeResult, all memory allocated by the service provider for this result is deallocated. See Section 3.13.

Error Codes If the function return is not WFS_SUCCESS, it is one of the following error conditions:

WFS_ERR_INTERNAL_ERROR

An internal inconsistency or other unexpected error occurred in the WOSA/XFS subsystem.

WFS_ERR_INVALID_RESULT

The lpResult parameter is not a pointer to an allocated WFSRESULT structure.

WFS_ERR_NOT_STARTED

The application has not previously performed a successful WFSStartUp.

See Also WFSExecute, WFSAsyncExecute, WFSGetInfo, WFSAsyncGetInfo