Funzione MsiOpenPackageA (msi.h)

Articolo
11/20/2024

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 sullo stesso thread prima di chiamare la funzione MsiOpenPackage, MsiOpenPackageExo 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 .

Osservazioni

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 operazione è destinata alle 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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

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 Requisiti di windows Run-Time.
piattaforma di destinazione	Finestre
intestazione	msi.h
libreria	Msi.lib
dll	Msi.dll

Vedere anche

funzioni di query del prodotto

Condividi tramite