IDataObject.GetCanonicalFormatEtc(IntPtr, IntPtr) Método

Definição

Recupera um ponteiro para uma estrutura FORMATETC padrão equivalente, mas não necessariamente igual, em termos lógicos à estrutura FORMATETC referenciada pelo parâmetro 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

Parâmetros

a
IntPtr

nativeint

Um ponteiro para o FORMATETC definindo o formato, a média e o dispositivo de destino para chamadas para recuperar dados.

b
IntPtr

nativeint

Um ponteiro de saída para um FORMATETC contendo as informações mais gerais possíveis para uma renderização específica ou null se o método GetCanonicalFormatEtc retornar DATA_S_SAMEFORMATETC.

Retornos

O método GetCanonicalFormatEtc é compatível com os valores retornados padrão E_INVALIDARG, E_UNEXPECTED e E_OUTOFMEMORY e também com os seguintes valores retornados:

Valor retornado Descrição
S_OK O FORMATETC retornado é diferente da estrutura passada nos parâmetros.
DATA_S_SAMEFORMATETC O FORMATETC retornado é o mesmo que a estrutura passada nos parâmetros e null é retornada em b.
DV_E_LINDEX lindex não é válido.
DV_E_FORMATETC a não é válido.
OLE_E_NOTRUNNING O aplicativo de objeto não está em execução.

Comentários

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

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

Aplica-se a