Funzione SHCreateItemInKnownFolder (shobjidl_core.h)

Crea un oggetto elemento shell per un singolo file esistente all'interno di una cartella nota.

Sintassi

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

Parametri

[in] kfid

Tipo: REFKNOWNFOLDERID

Riferimento a KNOWNFOLDERID, UN GUID che identifica la cartella che contiene l'elemento.

dwKFFlags

Tipo: DWORD

Flag che specificano opzioni speciali nel recupero dell'oggetto. Questo valore può essere 0; in caso contrario, uno o più valori KNOWN_FOLDER_FLAG .

[in, optional] pszItem

Tipo: PCWSTR

Puntatore a un buffer con terminazione Null che contiene il nome file del nuovo elemento come stringa Unicode. Questo parametro può anche essere NULL. In questo caso viene creato un oggetto IShellItem che rappresenta la cartella nota stessa.

[in] riid

Tipo: REFIID

Riferimento all'IID dell'interfaccia che rappresenta l'elemento, recuperato tramite ppv. Questo valore è in genere IID_IShellItem o IID_IShellItem2.

[out] ppv

Tipo: void**

Quando questa funzione viene restituita correttamente, contiene il puntatore di interfaccia richiesto in riid. Si tratta in genere di IShellItem o IShellItem2.

Valore restituito

Tipo: HRESULT

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shobjidl_core.h (include Shobjidl.h)
DLL	Shell32.dll
Set di API	ext-ms-win-shell-shell32-l1-2-0 (introdotto in Windows 8.1)

Vedi anche

Esempio di cartelle note