Idioma

IDataObject.GetCanonicalFormatEtc(IntPtr, IntPtr) Método

Definição

Recupera um ponteiro para uma estrutura padrão FORMATETC que é logicamente equivalente, mas não necessariamente igual, à FORMATETC estrutura referenciada pelo a parâmetro.

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

Parâmetros

a
IntPtr

nativeint

Um apontador para definir FORMATETC o formato, o meio e o dispositivo de destino para chamadas de recuperação de dados.

b
IntPtr

nativeint

Um ponteiro de saída para um FORMATETC contendo a informação mais geral possível para uma renderização específica, ou null se o método GetCanonicalFormatEtc devolve DATA_S_SAMEFORMATETC.

Devoluções

O método GetCanonicalFormatEtc suporta os valores padrão de retorno E_INVALIDARG, E_UNEXPECTED e E_OUTOFMEMORY, bem como os seguintes valores de retorno:

Valor de retorno Descrição
S_OK O FORMATETC devolvido é diferente da estrutura passada nos parâmetros.
DATA_S_SAMEFORMATETC O FORMATETC devolvido é igual à estrutura passada nos parâmetros e null é devolvido em b.
DV_E_LINDEX Lindex não é válido.
DV_E_FORMATETC a não é válido.
OLE_E_NOTRUNNING A aplicação objeto não está a correr.

Observações

O método GetCanonicalFormatEtc permite ao implementador da IDataObject interface devolver uma estrutura canónica FORMATETC sem duplicar a lógica de renderização da FORMATETC estrutura.

Para mais informações sobre programação com a interface IDataObject e o Consola de Gestão da Microsoft (MMC), consulte o Guia do Programador MMC.

Aplica-se a