SHCreateDataObject-Funktion (shlobj_core.h)

Erstellt ein Datenobjekt in einem übergeordneten Ordner.

Syntax

SHSTDAPI SHCreateDataObject(
  [in, optional] PCIDLIST_ABSOLUTE     pidlFolder,
  [in]           UINT                  cidl,
  [in, optional] PCUITEMID_CHILD_ARRAY apidl,
  [in, optional] IDataObject           *pdtInner,
  [in]           REFIID                riid,
  [out]          void                  **ppv
);

Parameter

[in, optional] pidlFolder

Typ: PCIDLIST_ABSOLUTE

Ein Zeiger auf eine ITEMIDLIST (PIDL) des übergeordneten Ordners, der das Datenobjekt enthält.

[in] cidl

Typ: UINT

Die Anzahl von Dateiobjekten oder Unterordnern, die im apidl-Parameter angegeben sind.

[in, optional] apidl

Typ: PCUITEMID_CHILD_ARRAY

Ein Array von Zeigern auf konstante ITEMIDLIST-Strukturen , von denen jede ein Dateiobjekt oder unterordner relativ zum übergeordneten Ordner eindeutig identifiziert. Jede Elementbezeichnerliste muss genau eine SHITEMID-Struktur gefolgt von einer endenden Null enthalten.

[in, optional] pdtInner

Typ: IDataObject*

Ein Zeiger auf die Schnittstelle von IDataObject. Dieser Parameter kann NULL sein. Geben Sie pdtInner nur an, wenn das erstellte Datenobjekt zusätzliche FORMATETC-Zwischenablageformate unterstützen muss, die über die Standardformate hinausgehen, die bei der Erstellung zugewiesen werden. Alternativ können Sie das Auffüllen des erstellten Datenobjekts mithilfe von nicht standardmäßigen Zwischenablageformaten unterstützen, indem Sie die Methode IDataObject::SetData aufrufen und das Format in der FORMATTC-Struktur angeben, die im Parameter pFormatetc übergeben wird.

[in] riid

Typ: REFIID

Ein Verweis auf die IID der Schnittstelle, die über ppv abgerufen werden soll. Dies muss IID_IDataObject sein.

[out] ppv

Typ: void**

Wenn diese Methode erfolgreich zurückgibt, enthält den in riid angeforderten IDataObject-Schnittstellenzeiger.

Rückgabewert

Typ: HRESULT

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

Hinweise

Diese Funktion wird in der Regel aufgerufen, wenn die Methode IShellFolder::GetUIObjectOf implementiert wird. Wenn ein Schnittstellenzeiger der Schnittstellen-ID IID_IDataObject angefordert wird (mithilfe des Parameters riid), kann der Implementierer den Schnittstellenzeiger für das objekt zurückgeben, das mit SHCreateDataObject als Antwort erstellt wurde.

Diese Funktion unterstützt das CFSTR_SHELLIDLIST -Zwischenablageformat (auch bekannt als HIDA) und bietet auch generische Unterstützung für beliebige Zwischenablageformate über IDataObject::SetData. Weitere Informationen zu Zwischenablageformaten finden Sie unter Shell-Zwischenablageformate.

Das neue Datenobjekt soll in Vorgängen wie drag-and-drop verwendet werden, in denen die Daten in der Zwischenablage mit einem bestimmten Format gespeichert werden.

Es wird empfohlen, das makro IID_PPV_ARGS zu verwenden, das in Objbase.h definiert ist, um die Parameter riid und ppv zu packen. Dieses Makro stellt die richtige IID basierend auf der Schnittstelle bereit, auf die der Wert in ppv verweist, wodurch die Möglichkeit eines Codierungsfehlers in riid beseitigt wird, der zu unerwarteten Ergebnissen führen kann.

Anforderungen

Weitere Informationen

CIDLData_CreateFromIDArray