Método IApplicationDestinations::SetAppID (shobjidl_core.h)
Especifica un identificador de modelo de usuario de aplicación único (AppUserModelID) para la aplicación desde cuya lista de accesos directos del botón de la barra de tareas los métodos de esta interfaz quitarán los destinos. Este método es opcional.
Sintaxis
HRESULT SetAppID(
[in] LPCWSTR pszAppID
);
Parámetros
[in] pszAppID
Tipo: LPCWSTR
Puntero al AppUserModelID del proceso cuya representación del botón de la barra de tareas recibe la lista de accesos directos.
Valor devuelto
Tipo: HRESULT
Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
Comentarios
Si la aplicación tiene un AppUserModelID explícito, se debe llamar a este método antes de llamar a RemoveAllDestinations o RemoveDestination.
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 IApplicationDestinations::RemoveDestination o IApplicationDestinations::RemoveAllDestinations . 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)