IShellFolder::SetNameOf

9/9/2008

Este método define o nome exibir de um objeto arquivo ou subpasta, alterando o identificador item no processo.

Syntax

HRESULT SetNameOf(
  HWND hwndOwner,
  LPCITEMIDLIST pidl,
  LPCOLESTR lpszName,
  DWORD uFlags,
  LPITEMIDLIST* ppidlOut
);

Parameters

• hwndOwner
  [no] Identificador para o janela proprietária de quaisquer caixas diálogo ou mensagem que exibe o cliente.

• pidl
  [no] Ponteiro para um ITEMIDLIST estrutura que identifica exclusivamente o objeto arquivo ou subpasta relativo para a pasta pai. A estrutura deve conter exatamente um SHITEMID estrutura seguida por um zero terminação.

• lpszName
  [no] Ponteiro para uma seqüência de caracteres NULL-Terminated que especifica o novo nome exibir.

• uFlags
  [no] Sinalizadores indicando o tipo especificado pelo nome a lpszName parâmetro. Para obter uma lista dos valores possíveis, consulte a descrição das SHGNO tipo enumerado.

• ppidlOut
  [out] Endereço de um ponteiro para um ITEMIDLIST estrutura que recebe o novo ITEMIDLIST.

Return Value

Retorna NOERROR se bem-sucedido, ou um valor de erro caso contrário.

Remarks

Implementações de IShellFolder::SetNameOf Geralmente, retornar um ponteiro para o novo ITEMIDLIST in a ppidlOut parâmetro, mas os chamadores desta interface devem ser capaz de manipulação de maiúsculas e minúsculas onde *ppidlOut não foi definida. Se você chamar IShellFolder::SetNameOf Com ppidlOut Definir como NULL, ele não retornará um novo ITEMIDLIST Para o objeto. Se ocorrer um erro, a implementação deve definir *ppidlOut Para NULL se ppidlOut não-NULL.

Alterar o nome de um objeto sistema de arquivos, ou uma pasta dentro dela, exibir renomeia o arquivo ou Diretório.

Antes chamado esse método, os aplicativos deve chamar IShellFolder::GetAttributesOf e verificar que o sinalizador SFGAO_CANRENAME está definido. Este sinalizador é essencialmente uma dica para clientes de espaço para nome. Ele não necessariamente implica que IShellFolder::SetNameOf será bem-sucedida ou falhar.

Requirements

Header	shobjidl.idl, Shobjvidl.h
Library	Developer Implemented
Windows Embedded CE	Windows CE .NET 4.2 and later

See Also

Reference

IShellFolder
ITEMIDLIST
SHITEMID
SHGNO
IShellFolder::GetAttributesOf