CIDLData_CreateFromIDArray-Funktion (shlobj_core.h)
[CIDLData_CreateFromIDArray ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt Anforderungen angegeben sind. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein.]
Erstellt ein Datenobjekt mit dem vtable-Standardzeiger.
Syntax
SHSTDAPI CIDLData_CreateFromIDArray(
[in] PCIDLIST_ABSOLUTE pidlFolder,
[in] UINT cidl,
[in] PCUIDLIST_RELATIVE_ARRAY apidl,
[out] IDataObject **ppdtobj
);
Parameter
[in] pidlFolder
Typ: PCIDLIST_ABSOLUTE
Eine vollqualifizierte IDLIST für den Stamm der elemente, die in apidl angegeben sind.
[in] cidl
Typ: UINT
Die Anzahl der Einträge im apidl-Array .
[in] apidl
Typ: PCUIDLIST_RELATIVE_ARRAY
Das Array von Element-IDs relativ zu pidlFolder. In der Regel ist apidl ein Array untergeordneter IDs, und pidlFolder ist eine vollständige PIDL für diese Elemente. PidlFolder kann jedoch null PIDL (Desktop-IDLISTs) sein. In diesem Fall kann apidl vollqualifizierte ID-Listen enthalten.
[out] ppdtobj
Typ: IDataObject**
Die Adresse auf einen Zeiger auf das Objekt, das IDataObject implementiert.
Rückgabewert
Typ: HRESULT
Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Das von dieser Funktion erstellte Datenobjekt bietet den Shell-Zwischenablageformatbezeichner CFSTR_SHELLIDLIST. Dieses Datenobjekt unterstützt auch IDataObject::SetData-Aufrufe , um andere Zwischenablageformate zu übernehmen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | shlobj_core.h (einschließlich Shlobj.h) |
| Bibliothek | Shell32.lib |
| DLL | Shell32.dll (Version 5.0 oder höher) |
| APIs | ext-ms-win-shell-shell32-l1-2-1 (eingeführt in Windows 10, Version 10.0.10240) |