Metodo ISyncMgrSyncItemInfo::GetComment (syncmgr.h)

Ottiene una stringa che contiene commenti relativi all'elemento.

Sintassi

HRESULT GetComment(
  [out] LPWSTR *ppszComment
);

Parametri

[out] ppszComment

Tipo: LPWSTR*

Quando questo metodo restituisce, contiene un puntatore a un buffer contenente la stringa di commento. Questa stringa è di lunghezza massima MAX_SYNCMGR_NAME incluso il carattere null terminante.

Valore restituito

Tipo: HRESULT

Restituisce S_OK se ha esito positivo o un valore di errore in caso contrario. Se il metodo ha esito negativo, ppszComment contiene una stringa vuota.

Commenti

Questa stringa può essere fornita da un elemento per visualizzare un riepilogo del relativo contenuto, ad esempio "32 contatti" o "13 canzoni". La stringa può avere una lunghezza massima di MAX_SYNCMGR_NAME incluso il carattere null terminante.

Il valore del commento viene visualizzato come proprietà System.Sync.Comments (PKEY_Sync_Comments) nell'interfaccia utente della cartella quando non viene eseguita una sincronizzazione.

Sync Center chiama questo metodo ogni volta che viene chiamato il metodo UpdateHandler .

L'elemento è responsabile dell'allocazione del buffer stringa a cui fa riferimento ppszComment tramite CoTaskMemAlloc. Sync Center dealloca il buffer stringa tramite CoTaskMemFree.

Requisiti