The
MsiViewClose function releases the result set for an executed view.
Syntax
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
| Version | Windows Installer 5.0 on Windows Server 2008 R2 or Windows 7. Windows Installer 4.0 or Windows Installer 4.5 on Windows Server 2008 or Windows Vista. Windows Installer on Windows Server 2003, Windows XP, and Windows 2000 |
|---|
| Header | Msiquery.h |
|---|
| Library | Msi.lib |
|---|
| DLL | Msi.dll |
|---|
See Also
- General Database Access Functions
Send comments about this topic to Microsoft
Build date: 11/12/2009