IShellFolder::GetUIObjectOf
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/9/2008
Este método recupera uma interface COM que pode ser usado para executar ações no arquivo especificado objetos ou pastas.
Syntax
HRESULT GetUIObjectOf(
HWND hwndOwner,
UINT cidl,
LPCITEMIDLIST* apidl,
REFIID riid,
UINT* rgfReserved,
VOID** ppv
);
Parameters
- hwndOwner
[no] Identificador para o janela proprietária que o cliente deve especificar se ele exibe uma caixa diálogo ou mensagem caixa.
- cidl
[no] Número de objetos arquivo ou subpastas especificadas na apidl parâmetro.
- apidl
[no] Endereço de uma matriz dos ponteiros para ITEMIDLIST estruturas, cada uma delas identifica exclusivamente um objeto arquivo ou subpasta relativo para a pasta pai. Cada lista identificador item deve conter exatamente um SHITEMID estrutura seguida por um zero terminação.
- riid
[no] Identificador do objeto interface COM para retornar. Isso pode ser qualquer válido identificador interface que pode ser criada para um item. The most comum identificadores utilizados pelo shell estão listados na " Comentários ".
- rgfReserved
Reservado.
- PPV
[out] Ponteiro para a interface solicitada. Se ocorrer um erro, um NULL ponteiro é retornado nesse endereço.
Return Value
Retorna NOERROR se bem-sucedido, E_NOINTERFACE se a interface não for com suporte, ou um valor de erro caso contrário.
Remarks
Se cidl é maior que um, o IShellFolder::GetUIObjectOf implementação deve êxito somente se ele pode criar um objeto para todos os itens especificados na apidl. Se a implementação não é possível criar um objeto para todos os itens, esse método deve falhar.
A seguinte tabela mostra the most comum identificadores interface de shell usa ao solicitar uma interface deste método. A tabela também indica se cidl pode ser maior que aquela para a interface solicitada.
| Interface identificador | Permitidos cidl valor |
|---|---|
IID_IContextMenu |
Pode ser maior ou igual a um. |
IID_IContextMenu2 |
Pode ser maior ou igual a um. |
IID_IDataObject |
Pode ser maior ou igual a um. |
IID_IDropTarget |
Só pode ser um. |
IID_IExtractIcon |
Só pode ser um. |
IID_IQueryInfo |
Só pode ser um. |
Requirements
| Header | shobjidl.h, shobjidl.idl |
| Library | Developer Implemented |
| Windows Embedded CE | Windows CE .NET 4.2 and later |