SHCreateItemInKnownFolder-Funktion (shobjidl_core.h)

Artikel
08/26/2023

Erstellt ein Shellelementobjekt für eine einzelne Datei, die in einem bekannten Ordner vorhanden ist.

Syntax

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

Parameter

[in] kfid

Typ: REFKNOWNFOLDERID

Ein Verweis auf die KNOWNFOLDERID, eine GUID , die den Ordner identifiziert, der das Element enthält.

dwKFFlags

Art: DWORD

Flags, die spezielle Optionen im Objektabruf angeben. Dieser Wert kann 0 sein. andernfalls mindestens einer der KNOWN_FOLDER_FLAG Werte.

[in, optional] pszItem

Typ: PCWSTR

Ein Zeiger auf einen Puffer mit NULL-Beendigung, der den Dateinamen des neuen Elements als Unicode-Zeichenfolge enthält. Dieser Parameter kann auch NULL sein. In diesem Fall wird ein IShellItem erstellt, das den bekannten Ordner selbst darstellt.

[in] riid

Typ: REFIID

Ein Verweis auf die IID der Schnittstelle, die das Element darstellt, das über ppv abgerufen wird. Dieser Wert ist in der Regel IID_IShellItem oder IID_IShellItem2.

[out] ppv

Typ: void**

Wenn diese Funktion erfolgreich zurückgegeben wird, enthält den in riid angeforderten Schnittstellenzeiger. Dies ist in der Regel IShellItem oder IShellItem2.

Rückgabewert

Typ: HRESULT

Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (einschließlich Shobjidl.h)
DLL	Shell32.dll
APIs	ext-ms-win-shell-shell32-l1-2-0 (eingeführt in Windows 8.1)

Weitere Informationen

Bekannte Ordner (Beispiel)

Share via