Método ICustomDestinationList::SetAppID (shobjidl_core.h)

Especifica un identificador de modelo de usuario de aplicación único (AppUserModelID) para la aplicación cuyo botón de barra de tareas contendrá la lista de accesos directos personalizada compilada a través de los métodos de esta interfaz. Este método es opcional.

Sintaxis

HRESULT SetAppID(
  [in] LPCWSTR pszAppID
);

Parámetros

[in] pszAppID

Tipo: LPCWSTR

Puntero al AppUserModelID del proceso o aplicación cuya representación de la barra de tareas recibe la lista de accesos directos.

Valor devuelto

Tipo: HRESULT

Devuelve S_OK si se ejecuta correctamente o un valor de error, incluido lo siguiente:

Código devuelto

Descripción

E_UNEXPECTED

Se llamó a este método después de ICustomDestinationList::BeginList. El proceso de creación de listas ya se está ejecutando con un AppUserModelID determinado, ya sea inferido por el sistema o establecido a través de una llamada a SetAppID antes de la llamada a BeginList. Después de que una operación de creación de listas esté en curso, appUserModelID no se puede cambiar hasta que se haya llamado a CommitList o AbortList .

Comentarios

Si una aplicación tiene un AppUserModelID explícito, debe llamar a SetAppID antes de llamar a ICustomDestinationList::BeginList o ICustomDestinationList::GetRemovedDestinations.

Después de especificar un AppUserModelID a través del método SetAppID de un objeto, appUserModelID se guarda en el objeto para la duración de ese objeto, siempre que no se sobrescriba mediante otra llamada a SetAppID.

Algunas aplicaciones no declararán un AppUserModelID explícito y no deben llamar a este método. En ese caso, la identidad de la aplicación se deduce cuando se llama a ICustomDestinationList::BeginList o ICustomDestinationList::GetRemovedDestinations . Sin embargo, hay una ventaja de rendimiento para evitar esos cálculos, por lo que se recomienda a las aplicaciones que proporcionen Listas de salto personalizado usar appUserModelID explícitos.

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)

ICustomDestinationList

SetCurrentProcessExplicitAppUserModelID

Extensiones de la barra de tareas