Função MsiCloseHandle (msi.h)
A função MsiCloseHandle fecha um identificador de instalação aberto.
Sintaxe
UINT MsiCloseHandle(
[in] MSIHANDLE hAny
);
Parâmetros
[in] hAny
Especifica qualquer identificador de instalação aberto.
Valor retornado
| Valor | Significado |
|---|---|
|
Um identificador inválido foi passado para a função . |
|
A função foi bem-sucedida. |
Comentários
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:
MsiCreateRecordMsiGetActiveDatabaseMsiGetLastErrorRecordMsiOpenPackageMsiOpenProductMsiOpenDatabaseMsiDatabaseOpenViewMsiViewFetchMsiViewGetColumnInfoMsiDatabaseGetPrimaryKeysMsiGetSummaryInformationMsiEnableUIPreview 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);
Requisitos
| 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 |