Sprache

IDataObject.GetCanonicalFormatEtc(IntPtr, IntPtr) Methode

Definition

Ruft einen Zeiger auf eine Standardstruktur FORMATETC ab, die logisch der Struktur entspricht, die jedoch nicht unbedingt gleich der Struktur ist, auf die FORMATETC durch den a Parameter verwiesen wird.

public:
 int GetCanonicalFormatEtc(IntPtr a, IntPtr b);
public int GetCanonicalFormatEtc(IntPtr a, IntPtr b);
abstract member GetCanonicalFormatEtc : nativeint * nativeint -> int
Public Function GetCanonicalFormatEtc (a As IntPtr, b As IntPtr) As Integer

Parameter

a
IntPtr

nativeint

Ein Zeiger auf das FORMATETC Definieren des Formats, des Mediums und des Zielgeräts für Aufrufe zum Abrufen von Daten.

b
IntPtr

nativeint

Ein Ausgabezeiger auf einen FORMATTC mit den allgemeinen Informationen, die für ein bestimmtes Rendering möglich sind, oder null wenn die GetCanonicalFormatEtc-Methode DATA_S_SAMEFORMATETC zurückgibt.

Gibt zurück

Die GetCanonicalFormatEtc-Methode unterstützt die Standardrücklaufwerte E_INVALIDARG, E_UNEXPECTED und E_OUTOFMEMORY sowie die folgenden Rückgabewerte:

Rückgabewert Description
S_OK Der zurückgegebene FORMATETC unterscheidet sich von der struktur, die in den Parametern übergeben wird.
DATA_S_SAMEFORMATETC Das zurückgegebene FORMATTC ist identisch mit der Struktur, die in den Parametern übergeben wird und null in bzurückgegeben wird.
DV_E_LINDEX lindex ist ungültig.
DV_E_FORMATETC a ist ungültig.
OLE_E_NOTRUNNING Die Objektanwendung wird nicht ausgeführt.

Hinweise

Die GetCanonicalFormatEtc-Methode ermöglicht es dem Implementierer der IDataObject Schnittstelle, eine kanonische FORMATETC Struktur zurückzugeben, ohne die Renderinglogik für die FORMATETC Struktur zu duplizieren.

Weitere Informationen zur Programmierung mit der schnittstelle IDataObject und dem Microsoft Management Console (MMC) finden Sie im Handbuch zum MMC-Programmierhandbuch.

Gilt für: