Funzione MsiOpenPackageA (msi.h)

  • Articolo

La funzione MsiOpenPackage apre un pacchetto da usare con le funzioni che accedono al database del prodotto. La funzione MsiCloseHandle deve essere chiamata con l'handle quando l'handle non è necessario.

Nota Inizializzare COM nello stesso thread prima di chiamare la funzione MsiOpenPackage, MsiOpenPackageEx o MsiOpenProduct .

 

Sintassi

UINT MsiOpenPackageA(
  [in]  LPCSTR    szPackagePath,
  [out] MSIHANDLE *hProduct
);

Parametri

[in] szPackagePath

Percorso del pacchetto.

[out] hProduct

Puntatore a una variabile che riceve l'handle del prodotto.

Valore restituito

Valore Significato
ERROR_BAD_CONFIGURATION
 Le informazioni di configurazione sono danneggiate.
ERROR_INSTALL_FAILURE
 Impossibile aprire il prodotto.
ERROR_INSTALL_REMOTE_PROHIBITED
 Windows Installer non consente l'installazione da una connessione Desktop remoto.
ERROR_INVALID_PARAMETER
 Alla funzione viene passato un parametro non valido.
ERROR_SUCCESS
 La funzione viene completata correttamente.
 

Se questa funzione ha esito negativo, può restituire un codice di errore di sistema. Per altre informazioni, vedere Codici di errore di sistema.

Commenti

MsiOpenPackage può accettare un handle di database aperto nel formato "#nnnn", dove nnnn è l'handle di database in formato stringa, ad esempio #123, anziché un percorso del pacchetto. Questa opzione è destinata ad attività di sviluppo, ad esempio l'esecuzione di azioni di convalida o per l'uso con gli strumenti di gestione del database.

Nota

L'intestazione msi.h definisce MsiOpenPackage come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito Valore
Client minimo supportato Windows Installer 5.0 in Windows Server 2012, Windows 8, Windows Server 2008 R2 o Windows 7. Windows Installer 4.0 o Windows Installer 4.5 in Windows Server 2008 o Windows Vista. Windows Installer in Windows Server 2003 o Windows XP. Per informazioni sul Service Pack minimo di Windows richiesto da una versione di Windows Installer, vedere Windows Installer Run-Time Requirements .See the Windows Installer requirements for information about the minimum Windows Service Pack that is required by a Windows Installer version.
Piattaforma di destinazione Windows
Intestazione msi.h
Libreria Msi.lib
DLL Msi.dll

Vedi anche

Funzioni di query prodotto