Método IApplicationDocumentLists::SetAppID (shobjidl_core.h)
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) |