Platform SDK: MAPI

IMsgServiceAdmin::MsgServiceTransportOrder

The IMsgServiceAdmin::MsgServiceTransportOrder method sets the order in which transport providers are called to deliver a message.

Quick Info

See IMsgServiceAdmin : IUnknown.

HRESULT MsgServiceTransportOrder(
  ULONG cUID,            
  LPMAPIUID lpUIDList,   
  ULONG ulFlags          
);
 

Parameters

cUID
[in] Count of unique identifiers in the lpUIDList parameter.
lpUIDList
[in] Pointer to an array of unique identifiers representing transport providers. The array contains one identifier for each transport provider configured in the current profile.
ulFlags
Reserved; must be zero.

Return Values

S_OK
The transport order was set successfully.
MAPI_E_BUSY
The value in the cUID parameter differs from the number of transport providers actually in the profile.
MAPI_E_NOT_FOUND
One or more of the MAPIUIDs passed in the lpUIDList parameter does not refer to a transport provider currently in the profile.

Remarks

The IMsgServiceAdmin::MsgServiceTransportOrder method sets the delivery order of transport providers within a profile. The lpUIDList parameter must contain a sorted list of transport-provider entry identifiers obtained from the PR_PROVIDER_UID property of the table returned from the IMsgServiceAdmin::GetProviderTable method. A client application must pass the complete list in lpUIDList.

SetTransportOrder overrides transport provider preferences such as the STATUS_XP_PREFER_LAST flag set in the PR_RESOURCE_FLAGS property.

See Also

MAPIUID