Share via

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

  • Artigo

Aplica um conjunto de propriedades a um item usando o mecanismo de cópia do Shell.

Sintaxe

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

Parâmetros

[in] psi

Tipo: IShellItem*

Ponteiro para o IShellItem que representa o arquivo que está sendo salvo. Geralmente, esse é o item recuperado por GetResult.

[in] pStore

Tipo: IPropertyStore*

Ponteiro para o IPropertyStore que representa os valores de propriedade a serem aplicados ao arquivo. Esse pode ser o repositório de propriedades retornado por IFileSaveDialog::GetProperties.

[in] hwnd

Digite: HWND

O identificador da janela do aplicativo.

[in] pSink

Tipo: IFileOperationProgressSink*

Ponteiro para um IFileOperationProgressSink opcional que o aplicativo de chamada pode usar se quiser ser notificado sobre o progresso da marcação da propriedade. Esse valor pode ser NULL.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Esse método deve ser usado quando o aplicativo ativa a coleção de propriedades (IFileSaveDialog::SetCollectedProperties), mas não persiste as propriedades no arquivo salvo.

Nota O arquivo representado pelo item especificado em psi deve existir no armazenamento físico antes de fazer a chamada para IFileSaveDialog::ApplyProperties, portanto, ele deve ter sido salvo anteriormente em algum momento.
 

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shobjidl_core.h