Condividi tramite


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, 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