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 ( _
    ByRef formatIn As FORMATETC, _
    <OutAttribute> ByRef formatOut As FORMATETC _
) As Integer Implements IDataObject.GetCanonicalFormatEtc

int IDataObject.GetCanonicalFormatEtc(
    ref FORMATETC formatIn,
    out FORMATETC formatOut
)

private:
virtual int GetCanonicalFormatEtc(
    FORMATETC% formatIn, 
    [OutAttribute] FORMATETC% formatOut
) sealed = IDataObject::GetCanonicalFormatEtc

private abstract GetCanonicalFormatEtc : 
        formatIn:FORMATETC byref * 
        formatOut:FORMATETC byref -> int 
private override GetCanonicalFormatEtc : 
        formatIn:FORMATETC byref * 
        formatOut:FORMATETC byref -> int 

JScript no admite implementaciones explícitas de interfaces.

Parámetros

• formatIn
  Tipo: System.Runtime.InteropServices.ComTypes.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.

• formatOut
  Tipo: System.Runtime.InteropServices.ComTypes.FORMATETC%
  Cuando este método vuelve, este parámetro contiene un puntero a una estructura de FORMATETC que contiene información general posible para una representación concreta, lo canónico el equivalente a pformatectIn.El llamador debe asignar esta estructura, y el método de GetCanonicalFormatEtc debe completar 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_UNEXPECTED, y E_OUTOFMEMORY, así como el siguiente:

Implementaciones

IDataObject.GetCanonicalFormatEtc(FORMATETC%, FORMATETC%)

Comentarios

Este método delega la llamada al GetCanonicalFormatEtc correspondiente del espacio de nombres de System.Runtime.InteropServices.ComTypes , suponiendo que el objeto del portapapeles está ajustando 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)