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