Funzione MsiSetComponentStateW (msiquery.h)

La funzione MsiSetComponentState imposta un componente sullo stato richiesto.

Sintassi

UINT MsiSetComponentStateW(
  [in] MSIHANDLE    hInstall,
  [in] LPCWSTR      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 da origine, CD o rete.

Valore restituito

La funzione MsiSetComponentState restituisce i valori seguenti:

Commenti

La funzione MsiSetComponentState richiede una modifica nello stato Azione 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 di errore estese 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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

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