Funzione MsiSummaryInfoGetPropertyA (msiquery.h)

Articolo
11/20/2024

La funzione msiSummaryInfoGetProperty ottiene una singola proprietà dal flusso di informazioni di riepilogo .

Nota Il significato del valore della proprietà dipende dal fatto che il flusso di informazioni di riepilogo si tratti di un database di installazione (file.msi), trasformazione (file con estensione mst) o patch (file msp). Per altre informazioni sulle proprietà di riepilogo, vedere e set di proprietà del flusso di informazioni di riepilogo.

Sintassi

UINT MsiSummaryInfoGetPropertyA(
  [in]      MSIHANDLE hSummaryInfo,
  [in]      UINT      uiProperty,
  [out]     PUINT     puiDataType,
  [out]     LPINT     piValue,
  [out]     FILETIME  *pftValue,
  [out]     LPSTR     szValueBuf,
  [in, out] LPDWORD   pcchValueBuf
);

Parametri

[in] hSummaryInfo

Handle per le informazioni di riepilogo.

[in] uiProperty

Specifica l'ID proprietà della proprietà summary. Questo parametro può essere un ID proprietà elencato nel set di proprietà riepilogo flusso informazioni. Questa funzione non restituisce valori per PID_DICTIONARY proprietà OR PID_THUMBNAIL.

[out] puiDataType

Riceve il tipo di proprietà restituito. Questo parametro può essere un tipo elencato in
set di proprietà del flusso di informazioni di riepilogo.

[out] piValue

Riceve i dati della proprietà Integer restituiti.

[out] pftValue

Puntatore a un valore di file.

[out] szValueBuf

Puntatore al buffer che riceve il valore della proprietà delle informazioni di riepilogo con terminazione Null. Non tentare di determinare le dimensioni del buffer passando un valore Null (value=0) per szValueBuf. È possibile ottenere le dimensioni del buffer passando una stringa vuota ,ad esempio "". La funzione restituisce quindi ERROR_MORE_DATA e pcchValueBuf contiene le dimensioni del buffer necessarie in TCHARs, senza includere il carattere Null di terminazione. In caso di restituzione di ERROR_SUCCESS, pcchValueBuf contiene il numero di TCHAR scritti nel buffer, senza includere il carattere Null di terminazione. Questo parametro è una stringa vuota se non sono presenti errori.

[in, out] pcchValueBuf

Puntatore alla variabile che specifica le dimensioni, in TCHARs, del buffer a cui punta la variabile szValueBuf. Quando la funzione restituisce ERROR_SUCCESS, questa variabile contiene le dimensioni dei dati copiati in szValueBuf, senza includere il carattere Null di terminazione. Se szValueBuf non è sufficientemente grande, la funzione restituisce ERROR_MORE_DATA e archivia le dimensioni necessarie, non includendo il carattere Null di terminazione, nella variabile a cui punta pcchValueBuf.

Valore restituito

La funzione msiSummaryInfoProperty restituisce uno dei valori seguenti:

Osservazioni

Se viene restituito ERROR_MORE_DATA, il parametro che è un puntatore restituisce le dimensioni del buffer necessario per contenere la stringa. Se viene restituito ERROR_SUCCESS, restituisce il numero di caratteri scritti nel buffer di stringa. È quindi possibile ottenere le dimensioni del buffer passando una stringa vuota (ad esempio "") per il parametro che specifica il buffer. Non tentare di determinare le dimensioni del buffer passando un valore Null (value=0).

Le funzioni di Windows Installer che restituiscono dati in un percorso di memoria fornito dall'utente non devono essere chiamate con null come valore per il puntatore. Queste funzioni restituiscono una stringa o restituiscono dati come puntatori integer, ma restituiscono valori incoerenti quando si passa null come valore per l'argomento di output. Per altre informazioni, vedere Passaggio di valori Null come argomento delle funzioni di Windows Installer.

Le informazioni sulla proprietà restituite dalla funzione MsiSummaryInfoGetProperty vengono ricevute dal parametro piValue, pftValueo parametro szValueBufBuf a seconda del tipo di valore della proprietà specificato nel parametro puiDataType.

Nota

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

passaggio di Null come argomento delle funzioni di Windows Installer

funzioni delle proprietà delle informazioni di riepilogo

set di proprietà del flusso di informazioni di riepilogo

Summaryinfo.Property

Condividi tramite