IOleObject::GetClipboardData-Methode (oleidl.h)

Artikel
08/25/2023

Ruft ein Datenobjekt ab, das den aktuellen Inhalt des eingebetteten Objekts enthält, für das diese Methode aufgerufen wird. Mithilfe des Zeigers auf dieses Datenobjekt ist es möglich, ein neues eingebettetes Objekt mit den gleichen Daten wie das Original zu erstellen.

Syntax

HRESULT GetClipboardData(
  [in]  DWORD       dwReserved,
  [out] IDataObject **ppDataObject
);

Parameter

[in] dwReserved

Dieser Parameter ist reserviert und muss null sein.

[out] ppDataObject

Adresse der IDataObject-Zeigervariable , die den Schnittstellenzeiger auf das Datenobjekt empfängt. Wenn ein Fehler auftritt, muss ppDataObject auf NULL festgelegt werden. Jedes Mal, wenn ein Objekt einen Aufruf von IOleObject::GetClipboardData empfängt, muss die Verweisanzahl für ppDataObject erhöht werden. Es liegt in der Verantwortung des Aufrufers , Release aufzurufen, wenn dies mit ppDataObject erfolgt.

Rückgabewert

Diese Methode gibt S_OK bei Erfolg zurück. Weitere mögliche Rückgabewerte:

Rückgabecode	Beschreibung
E_NOTIMPL	GetClipboardData wird nicht unterstützt.
OLE_E_NOTRUNNING	Das Objekt wird nicht ausgeführt.

Hinweise

Sie können die IOleObject::GetClipboardData-Methode verwenden, um ein verknüpftes Objekt in ein eingebettetes Objekt zu konvertieren. In diesem Fall würde die Containeranwendung IOleObject::GetClipboardData aufrufen und die empfangenen Daten dann an OleCreateFromData übergeben. Diese Methode gibt einen Zeiger auf ein Datenobjekt zurück, das mit dem identisch ist, was durch einen Standardkopiervorgang an die Zwischenablage übergeben worden wäre.

Hinweise für Anrufer

Wenn Sie eine stabile Momentaufnahme des aktuellen Inhalts eines eingebetteten Objekts wünschen, rufen Sie IOleObject::GetClipboardData auf. Sollten sich die Daten ändern, müssen Sie die Funktion für eine aktualisierte Momentaufnahme erneut aufrufen. Wenn der Aufrufer über Änderungen informiert werden soll, die an den Daten auftreten, rufen Sie QueryInterface auf, und rufen Sie dann IDataObject::D Advise auf.

Hinweise zu Implementierern

Wenn Sie diese Funktion implementieren, müssen Sie einen IDataObject-Zeiger für ein Objekt zurückgeben, dessen Daten sich nicht ändern.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	oleidl.h