IDispatchEx::GetMemberPropertiesIDispatchEx::GetMemberProperties*
*



Contents  *



Index  *Topic Contents

*Previous Topic: IDispatchEx::GetMemberName
*Next Topic: IDispatchEx::GetNameSpaceParent

IDispatchEx::GetMemberProperties

HRESULT GetMemberProperties(
   DISPID id,
   DWORD grfdexFetch,
   DWORD *pgrfdex
);

Retrieves a member's properties.

id
Identifies the member. Use GetDispID or GetNextDispID to obtain the dispatch identifier.
grfdexFetch
Determines which properties to retrieve. This can be a combination of the values listed under pgrfdex and/or a combination of the following values:
grfdexPropCanAll Combines fdexPropCanGet, fdexPropCanPut, fdexPropCanPutRef, fdexPropCanCall, fdexPropCanConstruct and fdexPropCanSourceEvents.
grfdexPropCannotAll Combines fdexPropCannotGet, fdexPropCannotPut, fdexPropCannotPutRef, fdexPropCannotCall, fdexPropCannotConstruct and fdexPropCannotSourceEvents.
grfdexPropExtraAll Combines fdexPropNoSideEffects and fdexPropDynamicType.
grfdexPropAll Combines grfdexPropCanAll, grfdexPropCannotAll and grfdexPropExtraAll.
pgrfdex
Address of a DWORD that receives the requested properties. This can be a combination of the following values:
fdexPropCanGet The member can be obtained using DISPATCH_PROPERTYGET.
fdexPropCannotGet The member cannot be obtained using DISPATCH_PROPERTYGET.
fdexPropCanPut The member can be set using DISPATCH_PROPERTYPUT.
fdexPropCannotPut The member cannot be set using DISPATCH_PROPERTYPUT.
fdexPropCanPutRef The member can be set using DISPATCH_PROPERTYPUTREF.
fdexPropCannotPutRef The member cannot be set using DISPATCH_PROPERTYPUTREF.
fdexPropNoSideEffects The member does not have any side effects. For example, a debugger could safely get/set/call this member without changing the state of the script being debugged.
fdexPropDynamicType The member is dynamic and can change during the lifetime of the object.
fdexPropCanCall The member can be called as a method using DISPATCH_METHOD.
fdexPropCannotCall The member cannot be called as a method using DISPATCH_METHOD.
fdexPropCanConstruct The member can be called as a constructor using DISPATCH_CONSTRUCT.
fdexPropCannotConstruct The member cannot be called as a constructor using DISPATCH_CONSTRUCT.
fdexPropCanSourceEvents The member can fire events.
fdexPropCannotSourceEvents The member cannot fire events.

Example 

BSTR bstrName;
   DISPID dispid;
   IDispatch *pdex; 
   DWORD dwProps;

   // Assign to pdex and bstrName
   pdex->GetDispID(bstrName, fdexNameCaseSensitive, &dispid);
   pdex->GetMemberProperties(dispid, grfdexPropAll, &dwProps);
   if (dwProps & fdexPropCanPut)
      // Assign to member

Up Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.