Compartir a través de

Método IFileSaveDialog::ApplyProperties (shobjidl_core.h)

  • Artículo

Aplica un conjunto de propiedades a un elemento mediante el motor de copia del Shell.

Sintaxis

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

Parámetros

[in] psi

Tipo: IShellItem*

Puntero al IShellItem que representa el archivo que se va a guardar. Normalmente, este es el elemento recuperado por GetResult.

[in] pStore

Tipo: IPropertyStore*

Puntero al IPropertyStore que representa los valores de propiedad que se van a aplicar al archivo. Puede ser el almacén de propiedades devuelto por IFileSaveDialog::GetProperties.

[in] hwnd

Tipo: HWND

Identificador de la ventana de la aplicación.

[in] pSink

Tipo: IFileOperationProgressSink*

Puntero a un IFileOperationProgressSink opcional que la aplicación que llama puede usar si desea recibir una notificación del progreso del stamping de propiedades. Este valor puede ser NULL.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Este método se debe usar cuando la aplicación ha activado la colección de propiedades (IFileSaveDialog::SetCollectedProperties), pero no conserva las propiedades en el archivo guardado.

Nota El archivo representado por el elemento especificado en psi debe existir en el almacenamiento físico antes de realizar la llamada a IFileSaveDialog::ApplyProperties, por lo que debe haberse guardado previamente en algún momento.
 

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shobjidl_core.h