Función GetCurrentProcessExplicitAppUserModelID (shobjidl_core.h)

  • Artículo

Recupera el identificador de modelo de usuario de aplicación (AppUserModelID) explícito definido por la aplicación para el proceso actual.

Sintaxis

SHSTDAPI GetCurrentProcessExplicitAppUserModelID(
  [out] PWSTR *AppID
);

Parámetros

[out] AppID

Tipo: PWSTR*

Puntero que recibe la dirección del AppUserModelID asignado al proceso. El autor de la llamada es responsable de liberar esta cadena con CoTaskMemFree cuando ya no es necesario.

Valor devuelto

Tipo: HRESULT

Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

El AppUserModelID recuperado por esta función se estableció anteriormente mediante SetCurrentProcessExplicitAppUserModelID.

Una aplicación solo puede recuperar un AppUserModelID que se ha establecido explícitamente. No se pueden recuperar los appUserModelID predeterminados asignados por el sistema. Si la aplicación requiere conocimiento de su AppUserModelID, debe establecer una explícitamente.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shobjidl_core.h (include Shobjidl.h)
Library Shell32.lib
Archivo DLL Shell32.dll (versión 6.1 o posterior)

Consulte también

Identificadores de modelo de usuario de aplicación (AppUserModelID)

IObjectWithAppUserModelID::GetAppID

Extensiones de la barra de tareas