Método IFileOperation::ApplyPropertiesToItems (shobjidl_core.h)

Declara um conjunto de itens para os quais aplicar um conjunto comum de valores de propriedade.

Sintaxe

HRESULT ApplyPropertiesToItems(
  [in] IUnknown *punkItems
);

Parâmetros

[in] punkItems

Tipo: IUnknown*

Ponteiro para o IUnknown do objeto IShellItemArray, IDataObject ou IEnumShellItems que representa o grupo de itens. Você também pode apontar para um objeto IPersistIDList para representar um único item, efetivamente realizando a mesma função que IFileOperation::ApplyPropertiesToItem.

Valor retornado

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 não aplica as propriedades aos itens, apenas declara os itens. Para definir valores de propriedade em um grupo de itens, você deve fazer pelo menos a sequência de chamadas detalhada aqui:

1. Chame IFileOperation::SetProperties para declarar as propriedades específicas a serem definidas e seus novos valores.
2. Chame IFileOperation::ApplyPropertiesToItems para declarar os itens cujos valores de propriedade devem ser definidos.
3. Chame IFileOperation::P erformOperations para aplicar as propriedades aos itens.

Requisitos

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 (inclua Shobjidl.h)

Confira também

Ifileoperation

IFileOperation::ApplyPropertiesToItem