Estrutura SHARDAPPIDINFOLINK (shlobj_core.h)

Contém dados usados por SHAddToRecentDocs para identificar um item, nesse caso por meio de um IShellLink, e o processo ao qual ele está associado.

Sintaxe

typedef struct SHARDAPPIDINFOLINK {
  IShellLink *psl;
  PCWSTR     pszAppID;
} SHARDAPPIDINFOLINK;

Membros

psl

Tipo: IShellLink*

Ponteiro para uma instância IShellLink que, quando iniciada, abre o item. O atalho não é adicionado por SHAddToRecentDocs à pasta Recente do usuário (CSIDL_RECENT, FOLDERID_Recent), mas é adicionado à categoria Recente na Lista de Saltos do aplicativo especificado.

pszAppID

Tipo: PCWSTR

O AppUserModelID definido pelo aplicativo associado ao item.

Comentários

A instância IShellLink apontada por psl deve fornecer o seguinte:

• Um ponteiro para uma lista de identificadores de item (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

Requisito	Valor
Cliente mínimo com suporte	Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Cabeçalho	shlobj_core.h (inclua Shlobj.h)

Confira também

IDs do modelo de usuário do aplicativo (AppUserModelIDs)

SHARDAPPIDINFO

SHARDAPPIDINFOIDLIST

SHAddToRecentDocs