ISocialSession2::GetActivitiesEx

Applies to: Office 2007 | Outlook 2010 | SharePoint Server 2010

Gets a string that represents a collection of activities of the user that is specified by the hashedAddresses parameter.

HRESULT _stdcall GetActivitiesEx([in] SAFEARRAY(BSTR) hashedAddresses, [in] DATE startTime, [out, retval] BSTR *activities);

Parameters

  • hashedAddresses
    [in] A structure that specifies an array of hashed SMTP addresses for a user.

  • startTime
    [in] The time after which activities that are created would be returned.

  • activities
    [out] An XML string that represents the set of activities of the user specified by hashedAddresses on the social network since startTime.

Remarks

The OSC calls GetActivitiesEx if the OSC provider supports on-demand or hybrid synchronization of activities. The OSC stores the information returned in activities in memory. For more information about how the OSC uses and updates this information in memory, see Synchronizing Friends and Activities.

Starting in OSC 1.1, the OSC never calls ISocialSession::GetActivities and ignores the value of dynamicActivitiesLookup. To support on-demand activities lookup, set getActivities as true and set dynamicActivitiesLookupEx as true, and the OSC will call GetActivitiesEx.

The returned XML string must comply with the schema definition for activityFeed, as defined in the schema for OSC provider extensibility.

If the OSC specifies more than one element in the array in the hashedAddresses parameter, the first element is always the hashed primary SMTP address. The hashed SMTP addresses are encrypted by using the hashing function specified by the hashFunction element in the provider’s capabilities XML. The user does not have to be a friend of the logged-on user represented by the ISocialSession::LoggedOnUserName property.

The startTime parameter is a Date value in Coordinated Universal Time (UTC). Local time values must be converted to UTC Date values.

Activities that the GetActivitiesEx method returns must have a creation time value that is greater than startTime and less than or equal to Now. If no changes have occurred between startTime and Now, the provider must return an OSC_E_NO_CHANGES error.

See Also

Reference

ISocialSession2 : IUnknown

Concepts

Synchronizing Friends and Activities