Compartilhar via


Função SetCurrentProcessExplicitAppUserModelID (shobjidl_core.h)

Especifica uma ID exclusiva do Modelo de Usuário do Aplicativo (AppUserModelID) definida pelo aplicativo que identifica o processo atual na barra de tarefas. Esse identificador permite que um aplicativo agrupe seus processos e janelas associados em um único botão da barra de tarefas.

Sintaxe

SHSTDAPI SetCurrentProcessExplicitAppUserModelID(
  [in] PCWSTR AppID
);

Parâmetros

[in] AppID

Tipo: PCWSTR

Ponteiro para o AppUserModelID a ser atribuído ao processo atual.

Retornar valor

Tipo: HRESULT

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Esse método deve ser chamado durante a rotina inicial de inicialização de um aplicativo antes que o aplicativo apresente qualquer interface do usuário ou faça qualquer manipulação de seu Jump Listas. Isso inclui qualquer chamada para SHAddToRecentDocs.

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)

GetCurrentProcessExplicitAppUserModelID

Extensões da barra de tarefas