Funzione MsiGetProductInfoExA (msi.h)

La funzione MsiGetProductInfoEx restituisce informazioni sul prodotto per i prodotti annunciati e installati. Questa funzione può recuperare informazioni

informazioni su un'istanza di un prodotto installato con un account utente diverso dall'utente corrente.

Il processo chiamante deve disporre di privilegi amministrativi per un utente diverso dall'utente corrente. La funzione MsiGetProductInfoEx non può eseguire query su un'istanza di un prodotto annunciato in un contesto non gestito per utente per un account utente diverso dall'utente corrente.

Questa funzione è un'estensione della funzione MsiGetProductInfo .

Sintassi

UINT MsiGetProductInfoExA(
  [in]                LPCSTR            szProductCode,
  [in]                LPCSTR            szUserSid,
  [in]                MSIINSTALLCONTEXT dwContext,
  [in]                LPCSTR            szProperty,
  [out, optional]     LPSTR             szValue,
  [in, out, optional] LPDWORD           pcchValue
);

Parametri

[in] szProductCode

GUID ProductCode dell'istanza del prodotto su cui viene eseguita una query.

[in] szUserSid

Identificatore di sicurezza (SID) dell'account in cui è presente l'istanza del prodotto su cui viene eseguita una query. Un valore NULL specifica il SID utente corrente.

[in] dwContext

Contesto di installazione dell'istanza del prodotto su cui viene eseguita una query.

[in] szProperty

Viene sottoposta a query sulla proprietà .

Proprietà da recuperare. Le proprietà nella tabella seguente possono essere recuperate solo dalle applicazioni già installate. Tutte le proprietà obbligatorie sono sicuramente disponibili, ma altre proprietà sono disponibili solo se la proprietà è impostata. Per ulteriori informazioni, vedere
Proprietà e proprietà obbligatorie.

Per recuperare l'ID prodotto, il proprietario registrato o la società registrata dalle applicazioni installate, impostare szProperty su uno dei valori stringa di testo seguenti.

Per recuperare il tipo di istanza del prodotto, impostare szProperty sul valore seguente. Questa proprietà è disponibile per i prodotti annunciati o installati.

Le proprietà nella tabella seguente possono essere recuperate dalle applicazioni annunciate o installate. Queste proprietà non possono essere recuperate per le istanze del prodotto installate in un contesto non gestito per utente per account utente diversi dall'account utente corrente.

[out, optional] szValue

Puntatore a un buffer che riceve il valore della proprietà. Questo buffer deve essere sufficientemente grande da contenere le informazioni. Se il buffer è troppo piccolo, la funzione restituisce ERROR_MORE_DATA e imposta *pcchValue sul numero di TCHAR nel valore, senza includere il carattere NULL di terminazione.

Se lpValue è impostato su NULL e pcchValue è impostato su un puntatore valido, la funzione restituisce ERROR_SUCCESS e imposta *pcchValue sul numero di TCHAR nel valore, senza includere il carattere NULL di terminazione. La funzione può quindi essere chiamata di nuovo per recuperare il valore, con buffer lpValue sufficientemente grande da contenere *pcchValue + 1 caratteri.

Se lpValue e pcchValue sono entrambi impostati su NULL, la funzione restituisce ERROR_SUCCESS se il valore esiste, senza recuperare il valore.

[in, out, optional] pcchValue

Puntatore a una variabile che specifica il numero di TCHAR nel buffer lpValue . Quando la funzione viene restituita, questo parametro viene impostato sulle dimensioni del valore richiesto indipendentemente dal fatto che la funzione copia il valore nel buffer specificato. La dimensione viene restituita come numero di TCHAR nel valore richiesto, senza includere il carattere Null di terminazione.

Questo parametro può essere impostato su NULL solo se lpValue è null. In caso contrario, la funzione restituisce ERROR_INVALID_PARAMETER.

Valore restituito

La funzione MsiGetProductInfoEx restituisce i valori seguenti.

Commenti

Quando viene restituita la funzione MsiGetProductInfoEx , il parametro pcchValue contiene la lunghezza della stringa archiviata nel buffer. Il conteggio restituito non include il carattere Null di terminazione. Se il buffer non è sufficientemente grande, MsiGetProductInfoEx restituisce ERROR_MORE_DATA e il parametro pcchValue contiene le dimensioni della stringa, in TCHAR, senza contare il carattere Null.

La funzione MsiGetProductInfoEx (INSTALLPROPERTY_LOCALPACKAGE) restituisce un percorso al pacchetto memorizzato nella cache. Il pacchetto memorizzato nella cache è solo per uso interno. Le installazioni in modalità manutenzione devono essere richiamate tramite le funzioni MsiConfigureFeature, MsiConfigureProduct o MsiConfigureProductEx .

La funzione MsiGetProductInfo restituisce ERROR_UNKNOWN_PROPERTY se l'applicazione sottoposta a query viene pubblicizzata e non installata. Ad esempio, se l'applicazione viene annunciata e non installata, una query per INSTALLPROPERTY_INSTALLLOCATION restituisce un errore di ERROR_UNKNOWN_PROPERTY.

Requisiti

Vedi anche

ARPHELPLINK

ARPHELPTELEPHONE

ARPINSTALLLOCATION

ARPPRODUCTICON

ARPURLINFOABOUT

ARPURLUPDATEINFO

Produttore

MsiConfigureFeature

MsiConfigureProduct

MsiConfigureProductEx

Non supportato in Windows Installer 2.0 e versioni precedenti

Codici di pacchetto

ProductCode

ProductID

ProductName

ProductVersion

Proprietà

Proprietà obbligatorie

SourceDir

Funzioni di stato del sistema