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에서 가리키는 문자열 버퍼를 할당합니다. 동기화 센터는 CoTaskMemFree를 통해 문자열 버퍼의 할당을 취소합니다.