CIDLData_CreateFromIDArray-Funktion (shlobj_core.h)

  • Artikel

[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)

Weitere Informationen

SHCreateDataObject