Compartilhar via


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

Declara um conjunto de itens que devem receber um novo nome de exibição. Todos os itens recebem o mesmo nome.

Sintaxe

HRESULT RenameItems(
  [in] IUnknown *pUnkItems,
  [in] LPCWSTR  pszNewName
);

Parâmetros

[in] pUnkItems

Tipo: IUnknown*

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

[in] pszNewName

Tipo: LPCWSTR

Ponteiro para o novo nome de exibição dos itens. Essa é uma cadeia de caracteres Unicode terminada em nulo.

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

Se mais de um dos itens da coleção em pUnkItems estiver na mesma pasta, os arquivos renomeados serão acrescentados com um número entre parênteses para diferenciá-los, por exemplo, newfile(1).txt, newfile(2).txt e newfile(3).txt.

Esse método não renomeia os itens, apenas declara os itens a serem renomeado. Para renomear um grupo de objetos, você deve fazer pelo menos a sequência de chamadas detalhada aqui:

  1. Chame IFileOperation::RenameItems para declarar os arquivos ou pastas de origem e o novo nome.
  2. Chame IFileOperation::P erformOperations para iniciar a operação de renomeação.

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

Confira também

Ifileoperation

IFileOperation::RenameItem