SHCreateItemInKnownFolder-Funktion (shobjidl_core.h)
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) |