WebSocketCompleteAction 함수(websocket.h)
WebSocketCompleteAction 함수는 WebSocketGetAction에서 시작한 작업을 완료합니다.
구문
void WebSocketCompleteAction(
[in] WEB_SOCKET_HANDLE hWebSocket,
[in] PVOID pvActionContext,
[in] ULONG ulBytesTransferred
);
매개 변수
[in] hWebSocket
WebSocketCreateClientHandle 또는 WebSocketCreateServerHandle에 대한 이전 호출에서 반환된 WebSocket 세션 핸들입니다.
[in] pvActionContext
형식: PVOID
WebSocketGetAction에 대한 이전 호출에서 반환된 작업 컨텍스트 핸들에 대한 포인터입니다.
[in] ulBytesTransferred
형식: ULONG
WEB_SOCKET_SEND_TO_NETWORK_ACTION 또는WEB_SOCKET_RECEIVE_FROM_NETWORK_ACTION 작업에 대해 전송된 바이트 수입니다. 이 값은 다른 모든 작업에 대해 0이어야 합니다.
반환 값
함수가 성공하면 S_OK를 반환합니다.
함수가 실패하면 WinError.h에 정의된 시스템 오류 코드 가 반환됩니다.
설명
WebSocketGetAction에 대한 각 호출은 WebSocketCompleteAction 호출과 페어링되어야 합니다. 다음 네트워크 작업의 경우 I/O 오류가 발생할 수 있습니다.
- WEB_SOCKET_SEND_TO_NETWORK_ACTION: ulBytesTransferred가 WebSocketGetAction에서 반환된 모든 버퍼 길이의 합계와 다른 경우 현재 보내기 작업이 취소되고 WebSocketGetAction에 대한 다음 호출은 WebSocketSend에 전달된 모든 버퍼가 처리되지 않은 경우에도 WEB_SOCKET_INDICATE_SEND_COMPLETE_ACTION 반환합니다.
- WEB_SOCKET_RECEIVE_FROM_NETWORK_ACTION: ulBytesTransferred가 0이면 현재 수신 작업이 취소되고 WebSocketGetAction에 대한 다음 호출은 WebSocketReceive에 전달된 모든 버퍼가 처리되지 않은 경우에도 WEB_SOCKET_INDICATE_RECEIVE_COMPLETE_ACTION 반환합니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows 8 [데스크톱 앱만 해당] |
지원되는 최소 서버 | Windows Server 2012 [데스크톱 앱만 해당] |
대상 플랫폼 | Windows |
헤더 | websocket.h |
라이브러리 | Websocket.lib |
DLL | Websocket.dll |