Função MsiCloseHandle (msi.h)

A função MsiCloseHandle fecha um identificador de instalação aberto.

Sintaxe

UINT MsiCloseHandle(
  [in] MSIHANDLE hAny
);

[in] hAny

Especifica qualquer identificador de instalação aberto.

Valor	Significado
ERROR_INVALID_HANDLE	Um identificador inválido foi passado para a função .
ERROR_SUCCESS	A função foi bem-sucedida.

MsiCloseHandle deve ser chamado do mesmo thread que solicitou a criação do identificador.

As seguintes funções fornecem identificadores que devem ser fechados após o uso chamando MsiCloseHandle:

MsiCreateRecord MsiGetActiveDatabase MsiGetLastErrorRecord MsiOpenPackage MsiOpenProduct MsiOpenDatabase MsiDatabaseOpenView MsiViewFetch MsiViewGetColumnInfo MsiDatabaseGetPrimaryKeys MsiGetSummaryInformation MsiEnableUIPreview Observe que, ao escrever ações personalizadas, é recomendável usar variáveis do tipo PMSIHANDLE porque o instalador fecha objetos PMSIHANDLE à medida que eles saem do escopo, enquanto você deve fechar objetos MSIHANDLE chamando MsiCloseHandle.

Por exemplo, se você usar um código parecido com este:

MSIHANDLE hRec = MsiCreateRecord(3);

Mude-a para:

PMSIHANDLE hRec = MsiCreateRecord(3);

Requisito	Valor
Cliente mínimo com suporte	Windows Installer 5.0 no Windows Server 2012, no Windows 8, no Windows Server 2008 R2 ou no Windows 7. Windows Installer 4.0 ou Windows Installer 4.5 no Windows Server 2008 ou no Windows Vista. Windows Installer no Windows Server 2003 ou no Windows XP. Confira os Requisitos de tempo de execução do Windows Installer para obter informações sobre o service pack mínimo do Windows exigido por uma versão do Windows Installer.
Plataforma de Destino	Windows
Cabeçalho	msi.h
Biblioteca	Msi.lib
DLL	Msi.dll