IShellFolder::CreateViewObject
9/9/2008
Este método solicita um objeto que pode ser usado para obter informações de ou interagir com um objeto pasta.
Syntax
HRESULT CreateViewObject(
HWND hwndOwner,
REFIID riid,
VOID** ppvOut
);
Parameters
- hwndOwner
[no] Identificador para o janela proprietária. Se você tiver implementado um personalizado objeto exibição pasta, a exibição pasta janela deve ser criada como um filho de hwndOwner.
- riid
[no] Identificador da interface solicitada.
- ppvOut
[out] Endereço de um ponteiro para a interface solicitada.
Return Value
Retorna NOERROR se bem-sucedido, ou um valor de erro caso contrário.
Remarks
Para suporte essa solicitação, criar um objeto que expõe a interface indicada por riid e retornar um ponteiro dessa interface.
O primário objetivo desse método é fornecer Explorer Windows com objeto exibição pasta do objeto de pasta. Explorer Windows solicita um objeto exibição pasta por configuração riid Para IID_IShellView. O objeto exibição pasta exibe o conteúdo da pasta na exibição de pasta Explorer Windows. O objeto exibição pasta deve ser independente do objeto de pasta shell porque Explorer Windows pode chamar este método mais de uma vez para criar múltiplo objetos exibição pasta. Um novo objeto exibição deve ser criado cada tempo Este método é chamado. O objeto pasta pode responder de uma destas duas maneiras para esta solicitação. Ele pode:
- Criar um personalizado objeto exibição pasta e retornar um ponteiro para sua IShellView interface.
- Criar um objeto exibição pasta sistema e retornar um ponteiro para sua IShellView interface.
Esse método também é usado para solicitação Objetos que expõem um dos vários opcional interfaces, inclusive IContextMenu Ou IExtractIcon. Neste contexto, IShellFolder::CreateViewObject é semelhante em uso IShellFolder::GetUIObjectOf. No entanto, você chamar IShellFolder::GetUIObjectOf a solicitação um objeto para um dos itens contidos por uma pasta. Chamar IShellFolder::CreateViewObject a solicitação um objeto para a pasta próprio.
Requirements
Header | shobjidl.h, shobjidl.idl |
Library | Developer Implemented |
Windows Embedded CE | Windows CE .NET 4.2 and later |