IDataObject.QueryGetData(FORMATETC) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Retrieves a value indicating whether the implementer can render the data that is contained in the a
parameter.
public:
int QueryGetData(Microsoft::Aspnet::Snapin::FORMATETC a);
public int QueryGetData (Microsoft.Aspnet.Snapin.FORMATETC a);
abstract member QueryGetData : Microsoft.Aspnet.Snapin.FORMATETC -> int
Public Function QueryGetData (a As FORMATETC) As Integer
Parameters
A pointer to the FORMATETC defining the format, medium, and target device for calls to retrieve data.
Returns
The QueryGetData 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 | A subsequent call to the GetData(FORMATETC, STGMEDIUM) method probably will be successful. |
DV_E_LINDEX | lindex is not valid. |
DV_E_FORMATETC | pFormatEtc is not valid. |
DV_E_TYMED | tymed is not valid. |
DV_E_DVASPECT | dwAspect value. |
OLE_E_NOTRUNNING | The object application is not running. |
Remarks
A client of a data object that implements the IDataObject interface calls the QueryGetData method to determine the likelihood of success of a subsequent call to the GetData(FORMATETC, STGMEDIUM) method. A result indicating that this instance of the IDataObject interface can render the data that is contained in the a
parameter does not guarantee success in a subsequent call to the GetData(FORMATETC, STGMEDIUM) method.
For more information about programming with the IDataObject interface and the Microsoft Management Console (MMC), see the MMC Programmer's Guide.