IDataObject.QueryGetData(FORMATETC) Method

Reference

Definition

Namespace:: Microsoft.Aspnet.Snapin

Assembly:: AspNetMMCExt.dll

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: FORMATETC

A pointer to the FORMATETC defining the format, medium, and target device for calls to retrieve data.

Returns

Int32

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.

Applies to