Compartilhar via


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

Especifica uma ID exclusiva do Modelo de Usuário do Aplicativo (AppUserModelID) para o aplicativo de cuja Lista de Saltos do botão da barra de tarefas os métodos dessa interface removerão destinos. Esse método é opcional.

Sintaxe

HRESULT SetAppID(
  [in] LPCWSTR pszAppID
);

Parâmetros

[in] pszAppID

Tipo: LPCWSTR

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

Retornar valor

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 RemoveAllDestinations ou RemoveDestination.

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 IApplicationDestinations::RemoveDestination ou IApplicationDestinations::RemoveAllDestinations são chamadas. 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)

IApplicationDestinations

Extensões da barra de tarefas