ISyncMgrHandlerInfo::GetComment method

Gets a string that contains commentary regarding the handler.

Syntax


HRESULT GetComment(
  [out] LPWSTR *ppszComment
);

Parameters

ppszComment [out]

Type: LPWSTR*

When this method returns, contains a pointer to a buffer containing the comment string. This string is of maximum length MAX_SYNCMGR_NAME including the terminating null character.

Return value

Type: HRESULT

Returns S_OK if successful, or an error value otherwise. If the method fails, ppszComment contains an empty string.

Remarks

This string could be provided by a handler to display a summary of contents of the partnership, for instance "32 contacts" or "13 songs". The string can have a maximum length of MAX_SYNCMGR_NAME including the terminating null character.

The comment value is displayed as the System.Sync.Comments (PKEY_Sync_Comments) property in the folder UI when a synchronization is not being performed.

Sync Center calls this method whenever the UpdateHandler method is called.

The handler is responsible for allocating the string buffer pointed to by ppszComment through CoTaskMemAlloc. Sync Center deallocates the string buffer through CoTaskMemFree.

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Syncmgr.h

IDL

Syncmgr.idl

 

 

Show: