The MsiViewClose function releases the result set for an executed view.

Syntax

C++UINT MsiViewClose(
  __in  MSIHANDLE hView
);

Parameters

hView [in]

Handle to a view that is set to release.

Return Value

ERROR_FUNCTION_FAILED

The function failed.

ERROR_INVALID_HANDLE

An invalid or inactive handle was supplied.

ERROR_INVALID_HANDLE_STATE

The handle is in an invalid state.

ERROR_SUCCESS

The function succeeded.

Note that in low memory situations, this function can raise a STATUS_NO_MEMORY exception.

Remarks

The MsiViewClose function must be called before the MsiViewExecute function is called again on the view, unless all rows of the result set have been obtained with the MsiViewFetch function.

Requirements

See Also

General Database Access Functions

Send comments about this topic to Microsoft

Build date: 8/13/2009