Compartilhar via


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
ERROR_INVALID_HANDLE
Um identificador inválido foi passado para a função .
ERROR_SUCCESS
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

Confira também

Funções de Gerenciamento de Identificadores