IDataObject.GetCanonicalFormatEtc(IntPtr, IntPtr) Metodo

Definizione

Recupera un puntatore alla struttura FORMATETC standard logicamente equivalente, ma non necessariamente uguale, alla struttura FORMATETC a cui fa riferimento il parametro 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

Parametri

a
IntPtr

nativeint

Puntatore alla struttura FORMATETC che definisce il formato, il supporto e il dispositivo di destinazione delle chiamate per il recupero dei dati.

b
IntPtr

nativeint

Puntatore di output a una struttura FORMATETC contenente le informazioni più generali possibile per un rendering specifico o null, se il metodo GetCanonicalFormatEtc restituisce DATA_S_SAMEFORMATETC.

Restituisce

Il metodo GetCanonicalFormatEtc supporta i valori restituiti standard E_INVALIDARG, E_UNEXPECTED ed E_OUTOFMEMORY e i valori restituiti indicati di seguito:

Valore restituito Descrizione
S_OK FormatETC restituito è diverso dalla struttura passata ai parametri.
DATA_S_SAMEFORMATETC FormatETC restituito corrisponde alla struttura passata nei parametri e null viene restituita in b.
DV_E_LINDEX lindex non è valido.
DV_E_FORMATETC a non è valido.
OLE_E_NOTRUNNING L'applicazione dell'oggetto non è in esecuzione.

Commenti

Il metodo GetCanonicalFormatEtc consente all'implementazione dell'interfaccia IDataObject di restituire una struttura canonica FORMATETC senza duplicare la logica di rendering per la FORMATETC struttura.

Per altre informazioni sulla programmazione con l'interfaccia IDataObject e la Microsoft Management Console (MMC), vedere la Guida del programmatore MMC.

Si applica a