ISyncMgrSynchronize::P repareForSync 메서드(mobsync.h)

아티클
08/24/2023

등록된 애플리케이션에서 사용자 인터페이스를 표시하고 ISyncMgrSynchronize::Synchronize 메서드가 호출되기 전에 필요한 초기화를 수행할 수 있습니다. 예를 들어 Microsoft Outlook 전자 메일 클라이언트와 같은 애플리케이션은 사용자가 메일 서버에 로그온할 수 있도록 암호 대화 상자를 표시해야 할 수 있습니다.

구문

HRESULT PrepareForSync(
  [in] ULONG cbNumItems,
  [in] GUID  *pItemIDs,
  [in] HWND  hWndParent,
  [in] DWORD dwReserved
);

매개 변수

[in] cbNumItems

형식: ULONG

pItemID가 가리키는 배열의 항목 수입니다.

[in] pItemIDs

형식: GUID*

사용자가 동기화하도록 선택하는 항목 ID의 배열입니다.

[in] hWndParent

형식: HWND

등록된 애플리케이션이 표시되는 모든 사용자 인터페이스 요소에 사용해야 하는 부모 HWND 에 대한 핸들입니다. 이 값은 NULL일 수 있습니다.

[in] dwReserved

형식:DWORD

예약되어 있습니다. 등록된 애플리케이션은 이 값을 무시해야 합니다.

반환 값

형식: HRESULT

이 메서드는 E_INVALIDARG, E_UNEXPECTED 및 E_OUTOFMEMORY 표준 반환 값과 다음을 지원합니다.

반환 코드	설명
S_OK	준비에 성공했습니다.

설명

등록된 애플리케이션 처리기는 가능한 한 빨리 이 메서드에서 반환한 다음 PrepareForSyncCompleted 메서드를 호출해야 합니다. 등록된 애플리케이션 처리기는 이 메서드에서 반환하기 전에 PrepareForSyncCompleted 메서드를 호출할 수 있습니다.

등록된 애플리케이션은 ISyncMgrSynchronize::Initialize 메서드의 dwSyncFlags 매개 변수에 SYNCMGRFLAG_MAYBOTHERUSER 플래그가 설정된 경우에만 사용자 인터페이스를 표시해야 합니다. 등록된 애플리케이션이 SYNCMGRFLAG_MAYBOTHERUSER 플래그가 설정되지 않은 경우 사용자 인터페이스를 표시하지 않고 동기화를 준비할 수 없는 경우 이 메서드에서 S_FALSE 반환해야 합니다.

이 메서드에 전달되는 항목 ID의 배열은 ISyncMgrSynchronize::Synchronize 메서드와도 관련이 있습니다.

등록된 애플리케이션의 모든 스레드에서 ISyncMgrSynchronizeCallback 메서드를 호출할 수 있습니다.

요구 사항


지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	mobsync.h
DLL	Mobsync.dll