Funzione MsiOpenPackageExA (msi.h)

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

Sintassi

UINT MsiOpenPackageExA(
  [in]  LPCSTR    szPackagePath,
  [in]  DWORD     dwOptions,
  [out] MSIHANDLE *hProduct
);

Parametri

[in] szPackagePath

Percorso del pacchetto.

[in] dwOptions

Flag di bit per indicare se ignorare o meno lo stato del computer. Passare 0 (zero) per usare comportamento msiOpenPackage.

[out] hProduct

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

Valore restituito

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

Osservazioni

Per creare un handle prodotto limitato indipendentemente dallo stato corrente della macchina e incapace di modificare lo stato corrente della macchina, usare MsiOpenPackageEx con MSIOPENPACKAGEFLAGS_IGNOREMACHINESTATE impostato in dwOptions.

Si noti che se dwOptions è MSIOPENPACKAGEFLAGS_IGNOREMACHINESTATE o 1, MsiOpenPackageEx ignora lo stato corrente della macchina durante la creazione dell'handle del prodotto. Se il valore di dwOptions è 0, MsiOpenPackageEx è uguale a MsiOpenPackage e crea un handle di prodotto che dipende dal fatto che il pacchetto specificato da szPackagePath sia già installato nel computer.

L'handle con restrizioni creato tramite MsiOpenPackageEx con MSIOPENPACKAGEFLAGS_IGNOREMACHINESTATE consente solo l'esecuzione di dialoghi, un subset delle azioni standard e azioni personalizzate che impostano le proprietà ( tipo di azione personalizzata 35, tipo di azione personalizzata 51e tipo di azione personalizzata 19). L'handle con restrizioni impedisce l'uso di azioni personalizzate che eseguono librerie Dynamic-Link, file eseguibili o script .

È possibile chiamare MsiDoAction sulle azioni standard seguenti usando l'handle con restrizioni. Tutte le altre azioni restituiscono ERROR_FUNCTION_NOT_CALLED se viene chiamato con l'handle con restrizioni.

• amministratore di
• INSTALL
• SEQUENCE
• 'azione Ricerca app
• CCPSearch
• CostFinalize
• CostInitialize
• FileCost
• FindRelatedProducts
• 'azione IsolateComponents
• LaunchConditions
• MigrateFeatureStates
• ResolveSource
• RMCCPSearch
• ValidateProductID