ISyncMgrSyncItem::GetName 메서드(syncmgr.h)

동기화 항목의 UI 표시 이름을 가져옵니다.

구문

HRESULT GetName(
  [out] LPWSTR *ppszName
);

매개 변수

[out] ppszName

형식: LPWSTR*

이 메서드가 반환되면 항목의 표시 이름을 포함하는 버퍼에 대한 포인터가 포함됩니다. 이 문자열은 종료 null 문자를 포함하여 MAX_SYNCMGR_NAME 최대 길이입니다. 이보다 긴 문자열은 잘립니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

GetName이 실패하거나 ppszItemID에서 빈 문자열이 반환되면 동기화 항목이 처리기의 폴더에 표시되지 않으며 동기화 센터에서 동기화를 시도하지 않습니다.

이 메서드에서 검색한 ID는 처리기의 폴더 UI에서 System.DisplayName(PKEY_DisplayName) 속성으로 사용할 수 있습니다.

항목은 CoTaskMemAlloc을 통해 ppszComment에서 가리키는 문자열 버퍼를 할당합니다. 동기화 센터는 CoTaskMemFree를 통해 문자열 버퍼의 할당을 취소합니다.

Sync Center는 UpdateItem 메서드를 호출할 때마다 이 메서드를 호출합니다.

이전 Sync Manager 구현에서 이 정보는 SYNCMGRHANDLERINFO 구조를 통해 검색되었습니다.

예제

다음 예제에서는 이 메서드의 구현을 보여줍니다.

STDMETHODIMP CMyDeviceSyncItem::GetName(__out LPWSTR *ppszName)
{
    *ppszName = NULL;
    HRESULT hr = SHCoAllocString(_pszItemName, ppszName);
    return hr;
}

요구 사항