Interface IObjectWithAppUserModelID (shobjidl_core.h)

Expõe métodos que permitem que os implementadores de um objeto IAssocHandler personalizado forneçam acesso à sua ID explícita do Modelo de Usuário do Aplicativo (AppUserModelID). Essas informações são usadas para determinar se um tipo de arquivo específico pode ser adicionado à Lista de Saltos de um aplicativo.

Herança

A interface IObjectWithAppUserModelID herda da interface IUnknown . IObjectWithAppUserModelID também tem estes tipos de membros:

Métodos

A interface IObjectWithAppUserModelID tem esses métodos.

IObjectWithAppUserModelID::GetAppID Recupera a ID explícita do modelo de usuário de aplicativo (AppUserModelID) de um manipulador de tipo de arquivo, se uma tiver sido declarada.
IObjectWithAppUserModelID::SetAppID Especifica uma ID exclusiva do Modelo de Usuário do Aplicativo (AppUserModelID) definida pelo aplicativo que identifica o objeto como um manipulador para um tipo de arquivo específico. Esse método é usado por aplicativos que exigem AppUserModelIDs dinâmicos.

Comentários

Somente os tipos de arquivo para os quais um aplicativo é um manipulador registrado aparecem na Lista de Saltos desse aplicativo. Quando um aplicativo usa um AppUserModelID explícito para identificar a si mesmo e as janelas e processos que pertencem a ele, esse AppUserModelID também deve ser definido na implementação de um manipulador para que o manipulador seja reconhecido como sendo associado a esse aplicativo. Quando o aplicativo acessa um arquivo de modo que SHAddToRecentDocs é chamado como resultado, é feita uma tentativa de adicionar o arquivo à categoria Recente ou Frequente , ou possivelmente uma categoria personalizada, na Lista de Saltos desse aplicativo. Se o aplicativo for um manipulador registrado para esse tipo de arquivo, identificado como tal pelo AppUserModelID do manipulador que corresponde ao AppUserModelID do aplicativo, esse arquivo será adicionado à Lista de Saltos. Caso contrário, ele é filtrado e não aparece.

Quando implementar

Uma implementação dessa interface é fornecida no Windows. Aplicativos que criam pastas shell personalizadas que expõem uma enumeração de manipulador de associação necessária pelo sistema para determinar os arquivos permitidos na Lista de Saltos do aplicativo devem implementar suas próprias versões.

Quando usar

Esse objeto só será necessário se o aplicativo estiver usando AppUserModelIDs explícitos. Sem um AppUserModelID explícito para expor, não há necessidade desse objeto.

IObjectWithAppUserModelID é sempre usado como parte de um objeto maior que usa AppUserModelIDs explícitos e deseja expor essas informações ao sistema.

O sistema chama o método IObjectWithAppUserModelID::GetAppID implementado em um manipulador para determinar se o aplicativo é um manipulador registrado para um tipo de arquivo.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shobjidl_core.h (inclua Shobjidl.h)

Confira também

IDs do modelo de usuário do aplicativo (AppUserModelIDs)

Extensões da barra de tarefas