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)