Función SetCurrentProcessExplicitAppUserModelID (shobjidl_core.h)

Especifica un identificador de modelo de usuario de aplicación (AppUserModelID) único definido por la aplicación que identifica el proceso actual en la barra de tareas. Este identificador permite que una aplicación agrupe sus procesos y ventanas asociados en un solo botón de la barra de tareas.

Sintaxis

SHSTDAPI SetCurrentProcessExplicitAppUserModelID(
  [in] PCWSTR AppID
);

Parámetros

[in] AppID

Tipo: PCWSTR

Puntero al appUserModelID para asignar al proceso actual.

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

Se debe llamar a este método durante la rutina de inicio inicial de una aplicación antes de que la aplicación presente cualquier interfaz de usuario o realice cualquier manipulación de su jump Listas. Esto incluye cualquier llamada a SHAddToRecentDocs.

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 (incluya 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 (AppUserModelIDs)

GetCurrentProcessExplicitAppUserModelID

Extensiones de la barra de tareas