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

Especifica uma ID exclusiva do Modelo de Usuário do Aplicativo (AppUserModelID) para o aplicativo cujo botão da barra de tarefas manterá a Lista de Atalhos personalizada criada por meio dos métodos dessa interface. Esse método é opcional.

Sintaxe

HRESULT SetAppID(
  [in] LPCWSTR pszAppID
);

Parâmetros

[in] pszAppID

Tipo: LPCWSTR

Um ponteiro para o AppUserModelID do processo ou aplicativo cuja representação da barra de tarefas recebe a Lista de Atalhos.

Retornar valor

Tipo: HRESULT

Retorna S_OK se tiver êxito ou um valor de erro, caso contrário, incluindo o seguinte:

Código de retorno

Descrição

E_UNEXPECTED

Esse método foi chamado após ICustomDestinationList::BeginList. O processo de criação de lista já está em execução com um AppUserModelID específico, inferido pelo sistema ou definido por meio de uma chamada para SetAppID antes da chamada para BeginList. Depois que uma operação de criação de lista estiver em andamento, o AppUserModelID não poderá ser alterado até que CommitList ou AbortList tenha sido chamado.

Comentários

Se um aplicativo tiver um AppUserModelID explícito, você deverá chamar SetAppID antes de chamar ICustomDestinationList::BeginList ou ICustomDestinationList::GetRemovedDestinations.

Depois que um AppUserModelID é especificado por meio do método SetAppID de um objeto, o AppUserModelID é salvo no objeto durante 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 ICustomDestinationList::BeginList ou ICustomDestinationList::GetRemovedDestinations são chamados . No entanto, há um benefício de desempenho em evitar esses cálculos, portanto, os aplicativos que fornecem Listas de salto personalizados são incentivados a usar AppUserModelIDs explícitos.

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]
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)

ICustomDestinationList

SetCurrentProcessExplicitAppUserModelID

Extensões da barra de tarefas