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