Função SHOpenFolderAndSelectItems (shlobj_core.h)

Abre uma janela do Windows Explorer com itens especificados em uma pasta específica selecionada.

Sintaxe

SHSTDAPI SHOpenFolderAndSelectItems(
  [in]           PCIDLIST_ABSOLUTE     pidlFolder,
                 UINT                  cidl,
  [in, optional] PCUITEMID_CHILD_ARRAY apidl,
                 DWORD                 dwFlags
);

Parâmetros

[in] pidlFolder

Tipo: PCIDLIST_ABSOLUTE

Um ponteiro para uma lista de IDs de item totalmente qualificada que especifica a pasta.

cidl

Tipo: UINT

Uma contagem de itens na matriz de seleção, apidl. Se cidl for zero, pidlFolder deverá apontar para um ITEMIDLIST totalmente especificado descrevendo um único item a ser selecionado. Essa função abre a pasta pai e seleciona esse item.

[in, optional] apidl

Tipo: PCUITEMID_CHILD_ARRAY

Um ponteiro para uma matriz de estruturas PIDL, cada uma delas é um item a ser selecionado na pasta de destino referenciada por pidlFolder.

dwFlags

Tipo: DWORD

Os sinalizadores opcionais. No Windows XP, esse parâmetro é ignorado. No Windows Vista, os sinalizadores a seguir são definidos.

OFASI_EDIT (0x0001)

Selecione um item e coloque seu nome no modo de edição. Esse sinalizador só pode ser usado quando um único item está sendo selecionado. Para várias seleções de itens, ela é ignorada.

OFASI_OPENDESKTOP (0x0002)

Selecione o item ou os itens na área de trabalho em vez de em uma janela do Windows Explorer. Observe que, se a área de trabalho estiver obscurecida atrás de janelas abertas, ela não ficará visível.

Retornar valor

Tipo: HRESULT

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

CoInitialize ou CoInitializeEx deve ser chamado antes de usar SHOpenFolderAndSelectItems. Não fazer isso faz com que SHOpenFolderAndSelectItems falhe.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shlobj_core.h (inclua Shlobj.h)
Biblioteca	Shell32.lib
DLL	Shell32.dll (versão 6.0 ou posterior)