IDataObject.GetCanonicalFormatEtc(IntPtr, IntPtr) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.