Funzione MsiSummaryInfoGetPropertyW (msiquery.h)
La funzione MsiSummaryInfoGetProperty ottiene una singola proprietà dal flusso di informazioni di riepilogo.
Sintassi
UINT MsiSummaryInfoGetPropertyW(
[in] MSIHANDLE hSummaryInfo,
[in] UINT uiProperty,
[out] PUINT puiDataType,
[out] LPINT piValue,
[out] FILETIME *pftValue,
[out] LPWSTR szValueBuf,
[in, out] LPDWORD pcchValueBuf
);
Parametri
[in] hSummaryInfo
Gestire le informazioni di riepilogo.
[in] uiProperty
Specifica l'ID proprietà della proprietà di riepilogo. Questo parametro può essere un ID proprietà elencato nel set di proprietà Riepilogo informazioni Stream. 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 nell'oggetto
Riepilogo informazioni Stream set di proprietà.
[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, non incluso il carattere null terminante. Al ritorno di ERROR_SUCCESS, pcchValueBuf contiene il numero di TCHAR scritti nel buffer, non incluso il carattere null terminante. 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, non incluso il carattere Null di terminazione. Se szValueBuf non è abbastanza grande, la funzione restituisce ERROR_MORE_DATA e archivia le dimensioni necessarie, non incluso il carattere Null terminante, nella variabile a cui punta pcchValueBuf.
Valore restituito
La funzione MsiSummaryInfoGetProperty restituisce uno dei valori seguenti:
Commenti
Se viene restituito ERROR_MORE_DATA, il parametro che è un puntatore fornisce le dimensioni del buffer necessario per contenere la stringa. Se ERROR_SUCCESS viene restituito, fornisce il numero di caratteri scritti nel buffer di stringa. È pertanto 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 interi, ma restituiscono valori incoerenti quando si passa null come valore per l'argomento di output. Per altre informazioni, vedere Passaggio di Null come argomento delle funzioni di Windows Installer.
Le informazioni sulla proprietà restituite dalla funzione MsiSummaryInfoGetProperty vengono ricevute dal parametro piValue, pftValue o szValueBuf 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 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
Passaggio di Null come argomento delle funzioni di Windows Installer
Funzioni delle proprietà Di riepilogo delle informazioni