Función SHCreateItemInKnownFolder (shobjidl_core.h)

Crea un objeto de elemento de Shell para un único archivo que existe dentro de una carpeta conocida.

Syntax

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

Parámetros

[in] kfid

Tipo: REFKNOWNFOLDERID

Referencia a KNOWNFOLDERID, un GUID que identifica la carpeta que contiene el elemento.

dwKFFlags

Tipo: DWORD

Marcas que especifican opciones especiales en la recuperación de objetos. Este valor puede ser 0; De lo contrario, uno o varios de los valores de KNOWN_FOLDER_FLAG .

[in, optional] pszItem

Tipo: PCWSTR

Puntero a un búfer terminado en null que contiene el nombre de archivo del nuevo elemento como una cadena Unicode. Este parámetro también puede ser NULL. En este caso, se crea un IShellItem que representa la propia carpeta conocida.

[in] riid

Tipo: REFIID

Referencia al IID de la interfaz que representa el elemento, recuperado a través de ppv. Este valor suele ser IID_IShellItem o IID_IShellItem2.

[out] ppv

Tipo: void**

Cuando esta función se devuelve correctamente, contiene el puntero de interfaz solicitado en riid. Normalmente es IShellItem o IShellItem2.

Valor devuelto

Tipo: HRESULT

Si esta función se ejecuta correctamente, devuelve S_OK. De lo contrario, devuelve un código de error HRESULT .

Requisitos

Consulte también

Ejemplo de carpetas conocidas