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 -> intPublic Function GetCanonicalFormatEtc (a As IntPtr, b As IntPtr) As IntegerParâmetros
- a
-
IntPtr
nativeint
Um ponteiro para definir o FORMATETC formato, o dispositivo médio e o dispositivo de destino para chamadas para recuperar dados.
- b
-
IntPtr
nativeint
Um ponteiro de saída para um FORMATETC que contém as informações mais gerais possíveis para uma renderização específica ou null se o método GetCanonicalFormatEtc retorna DATA_S_SAMEFORMATETC.
Retornos
O método GetCanonicalFormatEtc dá suporte aos valores retornados padrão E_INVALIDARG, E_UNEXPECTED e E_OUTOFMEMORY, bem como os seguintes valores retornados:
| Valor de devolução | Description |
|---|---|
| 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 é retornado 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 interface IDataObject e o Console de Gerenciamento Microsoft (MMC), consulte o guia do programador MMC.
