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

처리기의 표시 이름을 가져옵니다.

구문

HRESULT GetName(
  [out] LPWSTR *ppszName
);

매개 변수

[out] ppszName

형식: LPWSTR*

이 메서드가 반환될 때 처리기 이름을 수신하는 null로 종료된 버퍼에 대한 포인터를 포함합니다. 이름은 종료 null 문자를 포함하여 MAX_SYNCMGR_NAME 최대 길이일 수 있습니다. 이름이 해당 길이를 초과하면 잘립니다.

반환 값

형식: HRESULT

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

설명

처리기 이름은 동기화 센터 폴더의 System.DisplayName(PKEY_DisplayName) 속성으로 액세스됩니다.

Sync Center는 UpdateHandler 또는 UpdateHandlerCollection 이 호출되면 언제든지 이 메서드 를 호출합니다. ISyncMgrHandler::GetName이 실패하거나 빈 문자열을 반환하는 경우 처리기가 동기화 센터 폴더에 표시되지 않으며 동기화 센터에서 호출을 시도하지 않습니다.

CoTaskMemAlloc를 사용하여 문자열 버퍼를 할당하는 것은 처리기의 책임입니다. 동기화 센터는 CoTaskMemFree를 통해 버퍼의 할당을 취소합니다.

ISyncMgrHandler::GetName 은 GetHandlerInfo 를 사용하여 처리기 이름을 검색합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	syncmgr.h