Funzione MsiSetComponentStateA (msiquery.h)

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, MsiOpenPackageEx o MsiOpenProduct.

[in] szComponent

Specifica il nome del componente.

[in] iState

Specifica lo stato da impostare. Questo parametro può avere 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:

Commenti

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

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

Se la funzione ha esito negativo, è 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 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 selezione del programma di installazione