DataObject.IDataObject.GetCanonicalFormatEtc(FORMATETC, FORMATETC) Método

Definición

Espacio de nombres:

System.Windows

Ensamblado:

PresentationCore.dll

Proporciona una estructura estándar FORMATETC que es lógicamente equivalente a una estructura más compleja. Use este método para determinar si dos estructuras diferentes FORMATETC devolverían los mismos datos, eliminando la necesidad de representación duplicada.

 virtual int System.Runtime.InteropServices.ComTypes.IDataObject.GetCanonicalFormatEtc(System::Runtime::InteropServices::ComTypes::FORMATETC % pformatetcIn, [Runtime::InteropServices::Out] System::Runtime::InteropServices::ComTypes::FORMATETC % pformatetcOut) = System::Runtime::InteropServices::ComTypes::IDataObject::GetCanonicalFormatEtc;

[System.Security.SecurityCritical]
int IDataObject.GetCanonicalFormatEtc(ref System.Runtime.InteropServices.ComTypes.FORMATETC pformatetcIn, out System.Runtime.InteropServices.ComTypes.FORMATETC pformatetcOut);

[<System.Security.SecurityCritical>]
abstract member System.Runtime.InteropServices.ComTypes.IDataObject.GetCanonicalFormatEtc : FORMATETC * FORMATETC -> int
override this.System.Runtime.InteropServices.ComTypes.IDataObject.GetCanonicalFormatEtc : FORMATETC * FORMATETC -> int

Function GetCanonicalFormatEtc (ByRef pformatetcIn As FORMATETC, ByRef pformatetcOut As FORMATETC) As Integer Implements IDataObject.GetCanonicalFormatEtc

Parámetros

pformatetcIn

FORMATETC

Puntero a una FORMATETC estructura, pasada por referencia, que define el formato, el medio y el dispositivo de destino que el autor de la llamada desea usar para recuperar datos en una llamada posterior, como GetData(FORMATETC, STGMEDIUM). El TYMED miembro no es significativo en este caso y debe omitirse.

pformatetcOut

FORMATETC

Cuando este método vuelve, contiene un puntero a una FORMATETC estructura que contiene la información más general posible para una representación específica, lo que hace que sea canónicamente equivalente a formatetcIn. El autor de la llamada debe asignar esta estructura y el GetCanonicalFormatEtc(FORMATETC, FORMATETC) método debe rellenar los datos. Para recuperar datos en una llamada posterior, como GetData(FORMATETC, STGMEDIUM), el autor de la llamada usa el valor proporcionado de formatOut, a menos que el valor proporcionado sea null. Este valor es null si el método devuelve DATA_S_SAMEFORMATETC. El TYMED miembro no es significativo en este caso y debe omitirse. Este parámetro se pasa sin inicializar.

Devoluciones

Int32

Este método admite los valores devueltos estándar E_INVALIDARG, E_UNEXPECTED y E_OUTOFMEMORY, así como lo siguiente:

Valor	Descripción
S_OK	La estructura devuelta FORMATETC es diferente de la que se pasó.
DATA_S_SAMEFORMATETC	Las FORMATETC estructuras son las mismas y null se devuelven en el pformatetcOut parámetro .
DV_E_LINDEX	Hay un valor no válido para lindex; actualmente, solo se admite -1.
DV_E_FORMATETC	Hay un valor no válido para el pformatetcIn parámetro .
OLE_E_NOTRUNNING	La aplicación no se está ejecutando.

Implementaciones

GetCanonicalFormatEtc(FORMATETC, FORMATETC)

Atributos

SecurityCriticalAttribute

Comentarios

Este miembro es una implementación explícita de miembro de interfaz. Solo se puede usar cuando la DataObject instancia se convierte en una IDataObject interfaz.