Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

IS_SPECIAL_DATAOBJECT macro

The IS_SPECIAL_DATAOBJECT macro determines whether an LPDATAOBJECT passed by MMC in a call to the snap-in's Notify method is a special type of data object instead of a pointer to an actual IDataObject object.

Syntax


BOOL IS_SPECIAL_DATAOBJECT(
   INT_PTR d
);

Parameters

d

A value of type LPDATAOBJECT to be evaluated.

Return value

TRUE

Indicates that the value d is in the range from SPECIAL_DOBJ_MIN through SPECIAL_DOBJ_MAX (inclusive). Three values are defined in that range.

ValueMeaning
DOBJ_NULLIndicates that the d value is NULL, meaning that MMC does not require a data object for the notification message being sent. Examples of notification messages for which DOBJ_NULL is used include MMCN_FILTER_CHANGE and MMCN_FILTERBTN_CLICK.
DOBJ_CUSTOMOCXIndicates that the result pane contains a custom OCX.
DOBJ_CUSTOMWEBIndicates that the result pane contains a webpage.
DOBJ_NOCONSOLEIntroduced in MMC 1.2. This value not currently used.

 

FALSE

Indicates that the value d is not in the range SPECIAL_DOBJ_MIN to SPECIAL_DOBJ_MAX (inclusive). The data object is not one of the types described for the TRUE return value.

Remarks

MMC can pass DOBJ_CUSTOMOCX or DOBJ_CUSTOMWEB as the data object in the following methods with the following notifications:

If you have custom views (webpage, custom OCX, or taskpad), you can use this macro to verify that the notifications listed above pass a pointer to a data object or one of the special values, and then handle them appropriately.

Requirements

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2008

Header

Mmc.h

 

 

Show: