Enumeração SHARD (shlobj_core.h)

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:

• Um PIDL (IShellLink::SetIDList) ou o caminho de destino (IShellLink::SetPath ou IShellLink::SetRelativePath)
• Argumentos de linha de comando (IShellLink::SetArguments)
• Local do ícone (IShellLink::SetIconLocation)

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