IDataObject.GetCanonicalFormatEtc(IntPtr, IntPtr) Метод

Определение

Извлекает указатель на стандартную структуру FORMATETC, которая логически эквивалентна, но необязательно равна структуре FORMATETC, на которую ссылается параметр a.

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

Параметры

a
IntPtr

nativeint

Указатель на объект FORMATETC, определяющий формат, среду и целевое устройство для вызовов, с помощью которых извлекаются данные.

b
IntPtr

nativeint

Выходной указатель на FORMATETC, содержащий наиболее общие сведения для определенной отрисовки, или null, если метод GetCanonicalFormatEtc возвращает DATA_S_SAMEFORMATETC.

Возвращаемое значение

Метод GetCanonicalFormatEtc поддерживает стандартные возвращаемые значения E_INVALIDARG, E_UNEXPECTED и E_OUTOFMEMORY, а также следующие возвращаемые значения:

Возвращаемое значение Описание
S_OK Возвращаемый элемент FORMATETC отличается от структуры, передаваемой в параметрах.
DATA_S_SAMEFORMATETC Возвращаемый элемент FORMATETC совпадает со структурой, передаваемой в параметрах, и null возвращается в b.
DV_E_LINDEX Недопустимый lindex.
DV_E_FORMATETC Недопустимый параметр a.
OLE_E_NOTRUNNING Приложение-объект не выполняется.

Комментарии

Метод GetCanonicalFormatEtc позволяет разработчику IDataObject интерфейса возвращать каноническую FORMATETC структуру без дублирования логики отрисовки для FORMATETC структуры.

Дополнительные сведения о программировании с помощью IDataObject интерфейса и консоли управления (MMC) см. в руководстве по программированию MMC.

Применяется к