Compartilhar via


Função GetCurrentProcessExplicitAppUserModelID (shobjidl_core.h)

Recupera a ID do Modelo de Usuário do Aplicativo (AppUserModelID) definida pelo aplicativo para o processo atual.

Sintaxe

SHSTDAPI GetCurrentProcessExplicitAppUserModelID(
  [out] PWSTR *AppID
);

Parâmetros

[out] AppID

Tipo: PWSTR*

Um ponteiro que recebe o endereço do AppUserModelID atribuído ao processo. O chamador é responsável por liberar essa cadeia de caracteres com CoTaskMemFree quando ela não for mais necessária.

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

O AppUserModelID recuperado por essa função foi definido anteriormente por meio de SetCurrentProcessExplicitAppUserModelID.

Um aplicativo só pode recuperar um AppUserModelID que foi definido explicitamente. Os AppUserModelIDs padrão atribuídos pelo sistema não podem ser recuperados. Se o aplicativo exigir conhecimento de seu AppUserModelID, ele deverá definir um explicitamente.

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)

IObjectWithAppUserModelID::GetAppID

Extensões da barra de tarefas