Platform SDK: MAPI

IMAPISupport::GetSvcConfigSupportObj

The IMAPISupport::GetSvcConfigSupportObj method creates a message service support object.

Quick Info

See IMAPISupport : IUnknown.

HRESULT GetSvcConfigSupportObj(
  ULONG ulFlags,                 
  LPMAPISUP FAR * lppSvcSupport  
);
 

Parameters

ulFlags
Reserved; must be zero.
lppSvcSupport
[out] Pointer to a pointer to the new message service support object.

Return Values

S_OK
The configuration support object was successfully created.

Remarks

The IMAPISupport::GetSvcConfigSupportObj method is implemented for all support objects. Service providers call GetSvcConfigSupportObj to create a configuration support object to pass to a message service entry point function.

A message service entry point function is based on the MSGSERVICEENTRY prototype and is called by methods of the IMsgServiceAdmin interface. A message service entry point function allows message services to configure themselves or perform other actions when the profile is changed. Message service entry point functions can support configuration changes by displaying a property sheet or through a property value array passed to the IMsgServiceAdmin::ConfigureMsgService method.

See Also

IMsgServiceAdmin::CreateMsgService, IProfAdmin : IUnknown, MSGSERVICEENTRY