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 |
|---|---|
|
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)