Interfaz IObjectWithAppUserModelID (shobjidl_core.h)
Expone métodos que permiten a los implementadores de un objeto IAssocHandler personalizado proporcionar acceso a su identificador explícito del modelo de usuario de aplicación (AppUserModelID). Esta información se usa para determinar si se puede agregar un tipo de archivo determinado a la lista de accesos directos de una aplicación.
Herencia
La interfaz IObjectWithAppUserModelID hereda de la interfaz IUnknown . IObjectWithAppUserModelID también tiene estos tipos de miembros:
Métodos
La interfaz IObjectWithAppUserModelID tiene estos métodos.
|
IObjectWithAppUserModelID::GetAppID Recupera el identificador explícito del modelo de usuario de aplicación (AppUserModelID) del controlador de tipo de archivo, si se ha declarado uno. |
|
IObjectWithAppUserModelID::SetAppID Especifica un identificador de modelo de usuario de aplicación (AppUserModelID) único definido por la aplicación que identifica el objeto como controlador para un tipo de archivo específico. Las aplicaciones que requieren AppUserModelID dinámicos usan este método. |
Comentarios
Solo los tipos de archivo para los que una aplicación es un controlador registrado aparecen en la lista de accesos directos de esa aplicación. Cuando una aplicación usa un AppUserModelID explícito para identificarse y las ventanas y los procesos que lo pertenecen, ese AppUserModelID también debe establecerse en la implementación de un controlador para que el controlador se reconozca como asociado a esa aplicación. Cuando la aplicación accede a un archivo de forma que se llama a SHAddToRecentDocs como resultado, se intenta agregar el archivo a la categoría Recent o Frequent , o posiblemente una categoría personalizada, en la jump List de esa aplicación. Si la aplicación es un controlador registrado para ese tipo de archivo, identificado como tal por el AppUserModelID del controlador que coincide con el AppUserModelID de la aplicación, ese archivo se agrega a la lista de accesos directos. Si no es así, se filtra y no aparece.
Cuándo implementar
En Windows se proporciona una implementación de esta interfaz. Las aplicaciones que crean carpetas personalizadas de Shell que exponen una enumeración de controlador de asociación necesaria por el sistema para determinar los archivos permitidos en la lista de accesos directos de la aplicación deben implementar sus propias versiones.Cuándo usar
Este objeto solo es necesario si la aplicación usa appUserModelID explícitos. Sin un appUserModelID explícito que se exponga, no es necesario este objeto.IObjectWithAppUserModelID siempre se usa como parte de un objeto mayor que usa appUserModelID explícitos y quiere exponer esa información al sistema.
El sistema llama al método IObjectWithAppUserModelID::GetAppID implementado en un controlador para determinar si la aplicación es un controlador registrado para un tipo de archivo.
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) |
Consulte también
Identificadores de modelo de usuario de aplicación (AppUserModelIDs)