IDataObject::GetCanonicalFormatEtc Method
Assembly: AspNetMMCExt (in AspNetMMCExt.dll)
Parameters
- a
- Type: System::IntPtr
A pointer to the FORMATETC defining the format, medium, and target device for calls to retrieve data.
- b
- Type: System::IntPtr
An output pointer to a FORMATETC containing the most general information possible for a specific rendering.
-or-
nullptr, if the GetCanonicalFormatEtc method returns DATA_S_SAMEFORMATETC.
Return Value
Type: System::Int32The GetCanonicalFormatEtc method supports the standard return values E_INVALIDARG, E_UNEXPECTED, and E_OUTOFMEMORY, as well as the following return values:
Return value | Description |
|---|---|
S_OK | The returned FORMATETC is different from the structure passed in the parameters. |
DATA_S_SAMEFORMATETC | The returned FORMATETC is the same as the structure passed in the parameters and nullptr is returned in b. |
DV_E_LINDEX | lindex is not valid. |
DV_E_FORMATETC | a is not valid. |
OLE_E_NOTRUNNING | The object application is not running. |
The GetCanonicalFormatEtc method allows the implementer of the IDataObject interface to return a canonical FORMATETC structure without duplicating the rendering logic for the FORMATETC structure.
For more information about programming with the IDataObject interface and the Microsoft Management Console (MMC), see the "MMC Programmer's Guide" in the MSDN Library.
- Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.