Enumeração SHARD (shlobj_core.h)

  • Artigo

Indica a interpretação dos dados passados por SHAddToRecentDocs em seu parâmetro pv para identificar o item cujas estatísticas de uso estão sendo controladas.

Syntax

typedef enum {
  SHARD_PIDL,
  SHARD_PATHA,
  SHARD_PATHW,
  SHARD_APPIDINFO,
  SHARD_APPIDINFOIDLIST,
  SHARD_LINK,
  SHARD_APPIDINFOLINK,
  SHARD_SHELLITEM
} SHARD;

Constantes

 
SHARD_PIDL
O parâmetro pv aponta para um PIDL que identifica o objeto de arquivo do documento. PIDLs que identificam objetos que não são de arquivo não são aceitos.
SHARD_PATHA
O parâmetro pv aponta para uma cadeia de caracteres ANSI terminada em nulo com o caminho e o nome do arquivo do objeto.
SHARD_PATHW
O parâmetro pv aponta para uma cadeia de caracteres Unicode terminada em nulo com o caminho e o nome do arquivo do objeto.
SHARD_APPIDINFO
Windows 7 e posterior. O parâmetro pv aponta para uma estrutura SHARDAPPIDINFO que emparelha um IShellItem que identifica o item com um AppUserModelID que o associa a um determinado processo ou aplicativo.
SHARD_APPIDINFOIDLIST
Windows 7 e posterior. O parâmetro pv aponta para uma estrutura SHARDAPPIDINFOIDLIST que emparelha um PIDL absoluto que identifica o item com um AppUserModelID que o associa a um determinado processo ou aplicativo.
SHARD_LINK
Windows 7 e posterior. O parâmetro pv é um ponteiro de interface para um objeto IShellLink .
SHARD_APPIDINFOLINK
Windows 7 e posterior. O parâmetro pv aponta para uma estrutura SHARDAPPIDINFOLINK que emparelha um IShellLink que identifica o item com um AppUserModelID que o associa a um determinado processo ou aplicativo.
SHARD_SHELLITEM
Windows 7 e posterior. O parâmetro pv é um ponteiro de interface para um objeto IShellItem .

Comentários

Antes do Windows 7, SHARD_PIDL, SHARD_PATHA e SHARD_PATHW eram definidos como constantes individuais, não como membros de enumeração.

Ao fornecer um IShellLink por meio de SHARD_LINK ou SHARD_APPIDINFOLINK, a instância do IShellLink deve fornecer o seguinte:

O nome de exibição deve ser definido por meio da propriedade System.Title (PKEY_Title) do item. A propriedade pode conter diretamente o nome de exibição ou pode ser uma representação de cadeia de caracteres indireta, como "@shell32.dll,-1324", para usar uma cadeia de caracteres armazenada. Uma cadeia de caracteres indireta permite que o nome do item seja exibido no idioma selecionado do usuário.

Opcionalmente, o campo de descrição (IShellLink::SetDescription) pode ser definido para fornecer uma dica de ferramenta personalizada para o item na Lista de Saltos.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional, Windows XP, Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho shlobj_core.h (inclua Shlobj.h)

Confira também

SHAddToRecentDocs