Función SHCreateItemInKnownFolder (shobjidl_core.h)
Crea un objeto de elemento de Shell para un único archivo que existe dentro de una carpeta conocida.
Sintaxis
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. Suele ser IShellItem o IShellItem2.
Valor devuelto
Tipo: HRESULT
Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | shobjidl_core.h (include Shobjidl.h) |
| Archivo DLL | Shell32.dll |
| Conjunto de API | ext-ms-win-shell-shell32-l1-2-0 (introducido en Windows 8.1) |