IDataObject::GetDataHere-Methode (objidl.h)

Wird von einem Daten consumer aufgerufen, um Daten aus einem Quelldatenobjekt abzurufen. Diese Methode unterscheidet sich von der GetData-Methode darin, dass der Aufrufer das angegebene Speichermedium zuordnen und freigeben muss.

Syntax

HRESULT GetDataHere(
  [in]      FORMATETC *pformatetc,
  [in, out] STGMEDIUM *pmedium
);

Parameter

[in] pformatetc

Ein Zeiger auf die FORMATETC-Struktur , die das Format, das Medium und das Zielgerät definiert, das beim Übergeben der Daten verwendet werden soll. In tymed kann nur ein Medium angegeben werden, und nur die folgenden Werte sind gültig: TYMED_ISTORAGE, TYMED_ISTREAM, TYMED_HGLOBAL oder TYMED_FILE.

[in, out] pmedium

Ein Zeiger auf die STGMEDIUM-Struktur , der das Speichermedium definiert, das die übertragenen Daten enthält. Das Medium muss vom Aufrufer zugeordnet und von GetDataHere ausgefüllt werden. Der Aufrufer muss das Medium auch freigeben. Die Implementierung dieser Methode muss immer den Wert NULL für das punkForRelease-Element der STGMEDIUM-Struktur bereitstellen, auf die dieser Parameter verweist.

Rückgabewert

Diese Methode gibt S_OK bei Erfolg zurück. Weitere mögliche Werte sind:

Hinweise

Die GetDataHere-Methode ähnelt IDataObject::GetData, mit dem Unterschied, dass der Aufrufer das in pmedium angegebene Medium zuordnen und freigeben muss. GetDataHere rendert die in einer FORMATETC-Struktur beschriebenen Daten und kopiert die Daten in die vom Aufrufer bereitgestellte STGMEDIUM-Struktur . Wenn das Medium beispielsweise TYMED_HGLOBAL ist, kann diese Methode die Größe des Mediums nicht ändern oder eine neue hGlobal-Methode zuweisen.

Einige Medien sind für einen Aufruf von GetDataHere nicht geeignet, einschließlich GDI-Typen wie Metadateien. Die GetDataHere-Methode kann keine Daten in eine vom Aufrufer bereitgestellte Metadatei einfügen. Im Allgemeinen sind die einzigen Speichermedien, die in dieser Methode unterstützt werden müssen, TYMED_ISTORAGE, TYMED_ISTREAM und TYMED_FILE.

Wenn das Übertragungsmedium ein Stream ist, trifft OLE Annahmen darüber, wo die Daten zurückgegeben werden und die Position des Suchzeigers des Datenstroms. In einem GetData-Aufruf werden die zurückgegebenen Daten von der Streamposition 0 bis kurz vor dem aktuellen Suchzeiger des Datenstroms (d.a. der Position beim Beenden) zurückgegeben. Für GetDataHere stammen die zurückgegebenen Daten von der Streamposition beim Einstieg durch kurz vor der Position beim Beenden.

Anforderungen

Weitere Informationen

Idataobject