ISyncMgrSyncItemInfo::GetComment メソッド (syncmgr.h)

アイテムに関する解説を含む文字列を取得します。

構文

HRESULT GetComment(
  [out] LPWSTR *ppszComment
);

[out] ppszComment

種類: LPWSTR*

このメソッドが戻るときに、にはコメント文字列を含むバッファーへのポインターが含まれます。この文字列は、終端の null 文字を含む最大長MAX_SYNCMGR_NAMEです。

型: HRESULT

成功した場合はS_OK、それ以外の場合はエラー値を返します。メソッドが失敗した場合、 ppszComment には空の文字列が含まれます。

この文字列は、アイテムによって提供され、その内容の概要 ("32 連絡先" や "13 曲" など) を表示できます。文字列には、終端の null 文字を含むMAX_SYNCMGR_NAMEの最大長を指定できます。

同期が実行されていない場合、コメント値はフォルダー UI の System.Sync.Comments (PKEY_Sync_Comments) プロパティとして表示されます。

Sync Center は、UpdateHandler メソッドが呼び出されるたびにこのメソッドを呼び出します。

項目は、CoTaskMemAlloc を介して ppszComment が指す文字列バッファーを割り当てる役割を担います。 Sync Center は、CoTaskMemFree を介して文字列バッファーの割り当てを解除します。