Método IApplicationDocumentLists::SetAppID (shobjidl_core.h)
Especifica un identificador de modelo de usuario de aplicación único (AppUserModelID) para la aplicación cuyas listas de destino se están recuperando. 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 GetList.
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 IApplicationDocumentLists::GetList . Sin embargo, existe una ventaja de rendimiento para evitar esos cálculos, por lo que se recomienda que las aplicaciones que proporcionan listas de accesos directos personalizadas usen appUserModelID explícitos.
Requisitos
| 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)