Funzione MsiDoActionA (msiquery.h)

Articolo
11/20/2024

La funzione MsiDoAction esegue un'azione predefinita, un'azione personalizzata o un'azione guidata dell'interfaccia utente.

Sintassi

UINT MsiDoActionA(
  [in] MSIHANDLE hInstall,
  [in] LPCSTR    szAction
);

Parametri

[in] hInstall

Gestire l'installazione fornita a un'azione personalizzata DLL o ottenuta tramite MsiOpenPackage, MsiOpenPackageExo MsiOpenProduct.

[in] szAction

Specifica l'azione da eseguire.

Valore restituito

Questa funzione restituisce UINT.

Osservazioni

La funzione msiDoAction esegue l'azione corrispondente al nome specificato. Se il nome non viene riconosciuto dal programma di installazione come azione predefinita o come azione personalizzata nella tabella CustomAction, il nome viene passato all'oggetto gestore dell'interfaccia utente, che può richiamare una funzione o una finestra di dialogo. Se viene specificato un nome di azione Null, il programma di installazione usa il valore maiuscolo della proprietà ACTION come azione da eseguire. Se non viene definito alcun valore della proprietà, viene eseguita l'azione predefinita, definita come "INSTALL".

Le azioni che aggiornano il sistema, ad esempio InstallFiles e WriteRegistryValues azioni, non possono essere eseguite chiamando MsiDoAction. L'eccezione a questa regola è se MsiDoAction viene chiamato da un'azione personalizzata pianificata nella tabella InstallExecuteSequence tra InstallInitialize e Le azioni InstallFinalize. È possibile chiamare azioni che non aggiornano il sistema, ad esempio AppSearch o CostInitialize.

Nota

L'intestazione msiquery.h definisce MsiDoAction 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
piattaforma di destinazione	Finestre
intestazione	msiquery.h
libreria	Msi.lib
dll	Msi.dll

Vedere anche

funzioni di azione del programma di installazione di

Condividi tramite