Funzione MsiGetComponentStateA (msiquery.h)

Articolo
02/29/2024

La funzione MsiGetComponentState ottiene lo stato di un componente.

Sintassi

UINT MsiGetComponentStateA(
  [in]  MSIHANDLE    hInstall,
  [in]  LPCSTR       szComponent,
  [out] INSTALLSTATE *piInstalled,
  [out] INSTALLSTATE *piAction
);

Parametri

[in] hInstall

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

[in] szComponent

Stringa con terminazione Null che specifica il nome del componente all'interno del prodotto.

[out] piInstalled

Riceve lo stato installato corrente. Questo parametro non deve essere null. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
INSTALLSTATE_ABSENT	Il componente non è installato.
INSTALLSTATE_DEFAULT	Il componente viene installato nel percorso predefinito: locale o di origine.
INSTALLSTATE_LOCAL	Il componente viene installato nell'unità locale.
INSTALLSTATE_REMOVED	Il componente viene rimosso. Nello stato dell'azione e non impostabile.
INSTALLSTATE_SOURCE	Il componente viene eseguito dall'origine, dal CD-ROM o dalla rete.
INSTALLSTATE_UNKNOWN	Un prodotto o un nome di funzionalità non riconosciuto è stato passato alla funzione.

[out] piAction

Riceve l'azione eseguita durante l'installazione. Questo parametro non deve essere null. Per i valori restituiti, vedere piInstalled.

Valore restituito

La funzione MsiGetComponentState restituisce i valori seguenti:

Commenti

Se la funzione ha esito negativo, è possibile ottenere informazioni estese sull'errore usando MsiGetLastErrorRecord.

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

Nota

L'intestazione msiquery.h definisce MsiGetComponentState 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

Passaggio di Null come argomento delle funzioni di Windows Installer

Share via