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