ClipboardObject.IDataObject.GetCanonicalFormatEtc (Método)

Proporciona una estructura FORMATETC estándar que equivale lógicamente a una estructura más compleja.Utilice este método para determinar si dos diversas estructuras de FORMATETC devuelven los mismos datos, quitando la representación duplicada.

Espacio de nombres:  Microsoft.VisualStudio.Data.Framework
Ensamblado:  Microsoft.VisualStudio.Data.Framework (en Microsoft.VisualStudio.Data.Framework.dll)

Sintaxis

'Declaración
Private Function GetCanonicalFormatEtc ( _
    pformatectIn As FORMATETC(), _
    pformatetcOut As FORMATETC() _
) As Integer Implements IDataObject.GetCanonicalFormatEtc

int IDataObject.GetCanonicalFormatEtc(
    FORMATETC[] pformatectIn,
    FORMATETC[] pformatetcOut
)

private:
virtual int GetCanonicalFormatEtc(
    array<FORMATETC>^ pformatectIn, 
    array<FORMATETC>^ pformatetcOut
) sealed = IDataObject::GetCanonicalFormatEtc

private abstract GetCanonicalFormatEtc : 
        pformatectIn:FORMATETC[] * 
        pformatetcOut:FORMATETC[] -> int 
private override GetCanonicalFormatEtc : 
        pformatectIn:FORMATETC[] * 
        pformatetcOut:FORMATETC[] -> int 

JScript no admite implementaciones explícitas de interfaces.

Parámetros

• pformatectIn
  Tipo: array<Microsoft.VisualStudio.OLE.Interop.FORMATETC[]
  Una referencia a una estructura de FORMATETC , pasada por referencia, que define el formato, medio, y el dispositivo de destino que el llamador desea usar para recuperar datos en una llamada posterior, como IDataObject.GetData.El miembro tymed no es importante en este caso y se debe omitir.

• pformatetcOut
  Tipo: array<Microsoft.VisualStudio.OLE.Interop.FORMATETC[]
  El resultado que devuelve este método contiene un puntero a una estructura FORMATETC que contiene la máxima información general posible para una representación concreta, haciendo que tenga una equivalencia canónica con pformatectIn.El llamador debe asignar esta estructura y el método GetCanonicalFormatEtc debe rellenar los datos.Para recuperar datos en una llamada posterior, como IDataObject.GetData, las aplicaciones del llamador el valor proporcionado de pformatetcOut, a menos que el valor proporcionado es nullreferencia null (Nothing en Visual Basic).Este valor es NULL si el método devuelve DATA_S_SAMEFORMATETC.El miembro tymed no es importante en este caso y se debe omitir.Este parámetro se pasa sin inicializar.

Valor devuelto

Tipo: System.Int32
Este método admite los valores devueltos estándar E_INVALIDARG, E_FAIL, E_UNEXPECTED, y E_OUTOFMEMORY, así como el siguiente:

Implementaciones

IDataObject.GetCanonicalFormatEtc(array<FORMATETC[], array<FORMATETC[])

Comentarios

Si el objeto de portapapeles ajusta IDataObject existente (del espacio de nombres Microsoft.VisualStudio.OLE.Interop ), los delegados de este método la llamada al GetCanonicalFormatEtc correspondiente de ese espacio de nombres.Si no, intenta convertir la llamada al GetCanonicalFormatEtc de espacio de nombres de System.Runtime.InteropServices.ComTypes , en caso de que el objeto de portapapeles podría ajustar IDataObjectexistente.

Seguridad de .NET Framework

• Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.

Vea también

Referencia

ClipboardObject Clase

Microsoft.VisualStudio.Data.Framework (Espacio de nombres)