IDataObject.GetCanonicalFormatEtc(IntPtr, IntPtr) Methode

Definition

Ruft einen Zeiger auf eine FORMATETC-Standardstruktur ab, die der FORMATETC-Struktur, auf die der a-Parameter verweist, logisch äquivalent, aber nicht unbedingt gleich ist.

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, das das Format sowie Zwischen- und Zielgerät für Aufrufe zum Datenabruf definiert.

b
IntPtr

nativeint

Ein Ausgabezeiger auf ein FORMATETC-Objekt, das sehr allgemeine Informationen für ein bestimmtes Rendering enthält, oder null, wenn die GetCanonicalFormatEtc-Methode DATA_S_SAMEFORMATETC zurückgibt.

Gibt zurück

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

Rückgabewert BESCHREIBUNG
S_OK Der zurückgegebene FORMATETC unterscheidet sich von der Struktur, die in den Parametern übergeben wird.
DATA_S_SAMEFORMATETC Der zurückgegebene FORMATTC ist identisch mit der Struktur, die in den Parametern übergeben wird, und null wird in bzurückgegeben.
DV_E_LINDEX lindex ist ungültig.
DV_E_FORMATETC a ist nicht gü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 IDataObject Schnittstelle und der Microsoft Management Console (MMC) finden Sie im MMC-Programmierhandbuch.

Gilt für: