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