Funzione MsiSetComponentStateA (msiquery.h)

Articolo
11/20/2024

La funzione msiSetComponentState imposta un componente sullo stato richiesto.

Sintassi

UINT MsiSetComponentStateA(
  [in] MSIHANDLE    hInstall,
  [in] LPCSTR       szComponent,
  [in] INSTALLSTATE iState
);

Parametri

[in] hInstall

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

[in] szComponent

Specifica il nome del componente.

[in] iState

Specifica lo stato da impostare. Questo parametro può essere uno dei valori seguenti.

Valore	Significato
INSTALLSTATE_ABSENT	Il componente è stato disinstallato.
INSTALLSTATE_LOCAL	Il componente è stato installato nell'unità locale.
INSTALLSTATE_SOURCE	Il componente verrà eseguito dall'origine, dal CD o dalla rete.

Valore restituito

La funzione msiSetComponentState restituisce i valori seguenti:

Osservazioni

La funzione MsiSetComponentState richiede una modifica dello stato Action di un record nella tabella Component.

Per altre informazioni, vedere Chiamata di funzioni di database da programmi.

Se la funzione non riesce, è possibile ottenere informazioni estese sull'errore usando MsiGetLastErrorRecord.

Nota

L'intestazione msiquery.h definisce MsiSetComponentState 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 selezione del programma di installazione

Condividi tramite