Método IApplicationDocumentLists::SetAppID (shobjidl_core.h)

  • Artigo

Especifica uma ID exclusiva do modelo de usuário do aplicativo (AppUserModelID) para o aplicativo cujas listas de destino estão sendo recuperadas. Esse método é opcional.

Sintaxe

HRESULT SetAppID(
  [in] LPCWSTR pszAppID
);

Parâmetros

[in] pszAppID

Tipo: LPCWSTR

Um ponteiro para o AppUserModelID do processo cuja representação do botão da barra de tarefas recebe a Lista de Saltos.

Valor retornado

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 o aplicativo tiver um AppUserModelID explícito, esse método deverá ser chamado antes de chamar GetList.

Depois que um AppUserModelID é especificado por meio do método SetAppID de um objeto, o AppUserModelID é salvo no objeto para o tempo de vida desse objeto, desde que ele não seja substituído por outra chamada para SetAppID.

Alguns aplicativos não declararão um AppUserModelID explícito e não devem chamar esse método. Nesse caso, a identidade do aplicativo é deduzida quando IApplicationDocumentLists::GetList é chamado. No entanto, há um benefício de desempenho em evitar esses cálculos, portanto, os aplicativos que fornecem Listas de Saltos personalizadas são incentivados a usar AppUserModelIDs explícitos.

Requisitos

   
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]
Plataforma de Destino Windows
Cabeçalho shobjidl_core.h (inclua Shobjidl.h)
Biblioteca Shell32.lib
DLL Shell32.dll (versão 6.1 ou posterior)

Confira também

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

IApplicationDocumentLists

Extensões da barra de tarefas