Metodo IFileSaveDialog::ApplyProperties (shobjidl_core.h)

Articolo
03/02/2024

Applica un set di proprietà a un elemento usando il motore di copia di Shell.

Sintassi

HRESULT ApplyProperties(
  [in] IShellItem                 *psi,
  [in] IPropertyStore             *pStore,
  [in] HWND                       hwnd,
  [in] IFileOperationProgressSink *pSink
);

Parametri

[in] psi

Tipo: IShellItem*

Puntatore a IShellItem che rappresenta il file salvato. Questo è in genere l'elemento recuperato da GetResult.

[in] pStore

Tipo: IPropertyStore*

Puntatore a IPropertyStore che rappresenta i valori delle proprietà da applicare al file. Questo può essere l'archivio delle proprietà restituito da IFileSaveDialog::GetProperties.

[in] hwnd

Tipo: HWND

Handle della finestra dell'applicazione.

[in] pSink

Tipo: IFileOperationProgressSink*

Puntatore a un IFileOperationProgressSink facoltativo che l'applicazione chiamante può usare se si vuole ricevere una notifica dello stato di avanzamento del timbro della proprietà. Questo valore può essere NULL.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Questo metodo deve essere usato quando l'applicazione ha attivato la raccolta delle proprietà (IFileSaveDialog::SetCollectedProperties), ma non mantiene le proprietà stesse nel file salvato.

Nota Il file rappresentato dall'elemento specificato in psi deve esistere nell'archiviazione fisica prima di effettuare la chiamata a IFileSaveDialog::ApplyProperties, quindi deve essere stato salvato in precedenza in un certo momento.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shobjidl_core.h