PFN_WdsCliCallback 콜백 함수(wdsclientapi.h)

WDS가 파일 또는 이미지 전송 중에 진행률 알림 및 오류 메시지를 호출할 수 있는 콜백 함수를 정의합니다.

구문

PFN_WdsCliCallback PfnWdsclicallback;

void PfnWdsclicallback(
  [in]           DWORD dwMessageId,
  [in, optional] WPARAM wParam,
  [in, optional] LPARAM lParam,
  [in, optional] PVOID pvUserData
)
{...}

매개 변수

[in] dwMessageId

메시지 형식 및 lParam 매개 변수의 의미입니다.

이 매개 변수는 다음 값 중 하나만 가질 수 있습니다.

값	의미
WDS_CLI_MSG_START 0	전송 시작 메시지입니다. lParam 매개 변수는 전송의 파일 크기를 포함하는 LARGE_INTEGER 값에 대한 포인터입니다.
WDS_CLI_MSG_COMPLETE 1	전송 완료 메시지입니다. lParam 매개 변수는 HRESULT 값입니다.
WDS_CLI_MSG_PROGRESS 2	전송 진행률 메시지입니다. lParam 매개 변수는 완료된 전송의 백분율인 ULONG 값입니다.
WDS_CLI_MSG_TEXT 3	정보 메시지입니다. lParam 매개 변수는 진단 목적으로 사용할 수 있는 디버깅 문자열에 대한 포인터입니다.

[in, optional] wParam

이 메시지 매개 변수는 항상 WdsCliTransferImage 또는 WdsCliTransferFile 함수에서 반환된 전송 핸들 값으로 설정해야 합니다.

[in, optional] lParam

이 매개 변수에 포함된 값의 의미는 dwMessageId 매개 변수에 따라 달라집니다.

[in, optional] pvUserData

WdsCliTransferImage 또는 WdsCliTransferFile 함수에 의해 이 세션에 연결된 선택적 사용자 정보에 대한 포인터입니다.

반환 값

없음

설명

콜백 함수는 WdsCliCancelTransfer 함수를 호출하여 전송을 취소할 수 있습니다. 콜백 함수는 WdsCliWaitForTransfer 함수를 호출할 수도 있지만 현재 콜백이 차단 해제될 때까지 추가 콜백이 수신되지 않으므로 권장되지 않습니다.

요구 사항

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