Funzione MsiSequenceA (msiquery.h)

La funzione MsiSequence esegue un'altra sequenza di azioni, come descritto nella tabella specificata.

Sintassi

UINT MsiSequenceA(
  [in] MSIHANDLE hInstall,
  [in] LPCSTR    szTable,
  [in] INT       iSequenceMode
);

Parametri

[in] hInstall

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

[in] szTable

Specifica il nome della tabella contenente la sequenza di azione.

[in] iSequenceMode

Questo parametro non è attualmente implementato. È riservato per uso futuro e deve essere 0.

Valore restituito

Questa funzione restituisce UINT.

Commenti

La funzione MsiSequence esegue una query sulla tabella specificata, ordinando le azioni in base ai numeri nella colonna Sequenza. Per ogni riga recuperata, viene eseguita un'azione, purché qualsiasi espressione di condizione fornita non restituisca FALSE.

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

Nota

L'intestazione msiquery.h definisce MsiSequence 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
Piattaforma di destinazione Windows
Intestazione msiquery.h
Libreria Msi.lib
DLL Msi.dll

Vedi anche

Funzioni di azione del programma di installazione