Metodo ISyncMgrHandlerInfo::GetComment (syncmgr.h)

Articolo
08/26/2023

Ottiene una stringa che contiene commenti relativi al gestore.

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 gestore per visualizzare un riepilogo del contenuto della partnership, 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 .

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

Requisiti


Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	syncmgr.h

Condividi tramite