Função SHCreateItemInKnownFolder (shobjidl_core.h)

  • Artigo

Cria um objeto de item shell para um único arquivo que existe dentro de uma pasta conhecida.

Sintaxe

SHSTDAPI SHCreateItemInKnownFolder(
  [in]           REFKNOWNFOLDERID kfid,
                 DWORD            dwKFFlags,
  [in, optional] PCWSTR           pszItem,
  [in]           REFIID           riid,
  [out]          void             **ppv
);

Parâmetros

[in] kfid

Tipo: REFKNOWNFOLDERID

Uma referência ao KNOWNFOLDERID, um GUID que identifica a pasta que contém o item.

dwKFFlags

Tipo: DWORD

Sinalizadores que especificam opções especiais na recuperação de objeto. Esse valor pode ser 0; caso contrário, um ou mais dos valores KNOWN_FOLDER_FLAG .

[in, optional] pszItem

Tipo: PCWSTR

Um ponteiro para um buffer terminado em nulo que contém o nome do arquivo do novo item como uma cadeia de caracteres Unicode. Esse parâmetro também pode ser NULL. Nesse caso, um IShellItem que representa a própria pasta conhecida é criado.

[in] riid

Tipo: REFIID

Uma referência ao IID da interface que representa o item, recuperado por meio de ppv. Normalmente, esse valor é IID_IShellItem ou IID_IShellItem2.

[out] ppv

Tipo: void**

Quando essa função retorna com êxito, contém o ponteiro de interface solicitado em riid. Normalmente, isso é IShellItem ou IShellItem2.

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.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shobjidl_core.h (inclua Shobjidl.h)
DLL Shell32.dll
Conjunto de APIs ext-ms-win-shell-shell32-l1-2-0 (introduzido no Windows 8.1)

Confira também

Exemplo de pastas conhecidas