277 lines
8.7 KiB
C
277 lines
8.7 KiB
C
#ifndef _ANTICPX_SERVER_H_
|
|
#define _ANTICPX_SERVER_H_
|
|
|
|
// 유효하지 않은 핸들을 의미한다
|
|
#define ANTICPX_INVALID_HANDLE_VALUE (0)
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
// 에러 코드
|
|
//////////////////////////////////////////////////////////////////////////
|
|
|
|
#define ANTICPXSVR_BASECODE_ERROR 0xE9040000
|
|
|
|
// 파일에 접근 권한이 없습니다
|
|
#define ERROR_ANTICPXSVR_FILE_ACCESS_DENIED (ANTICPXSVR_BASECODE_ERROR + 0x1)
|
|
// 파일을 찾을 수가 없습니다
|
|
#define ERROR_ANTICPXSVR_FILE_NOT_FOUND (ANTICPXSVR_BASECODE_ERROR + 0x2)
|
|
// 입력값이 올바르지 않습니다
|
|
#define ERROR_ANTICPXSVR_INVALID_PARAMETER (ANTICPXSVR_BASECODE_ERROR + 0x3)
|
|
// 올바른 포멧이 아닙니다
|
|
#define ERROR_ANTICPXSVR_BAD_FORMAT (ANTICPXSVR_BASECODE_ERROR + 0x4)
|
|
// 요청에 대한 응답을 받지 않았습니다
|
|
#define ERROR_ANTICPXSVR_NOT_YET_RECEIVED_RESPONSE (ANTICPXSVR_BASECODE_ERROR + 0x5)
|
|
// 대기하고 있지 않습니다
|
|
#define ERROR_ANTICPXSVR_NO_WAITING (ANTICPXSVR_BASECODE_ERROR + 0x6)
|
|
// 메모리가 부족합니다
|
|
#define ERROR_ANTICPXSVR_NOT_ENOUGH_MEMORY (ANTICPXSVR_BASECODE_ERROR + 0x7)
|
|
// 송수신된 메시지가 올바르지 않습니다
|
|
#define ERROR_ANTICPXSVR_BAD_MESSAGE (ANTICPXSVR_BASECODE_ERROR + 0x8)
|
|
// 패킷 분석을 위한 재전송 공격이 감지되었습니다
|
|
#define ERROR_ANTICPXSVR_REPLY_ATTACK (ANTICPXSVR_BASECODE_ERROR + 0x9)
|
|
// 핵쉴드 모듈 변조가 감지되었습니다
|
|
#define ERROR_ANTICPXSVR_HSHIELD_FILE_ATTACK (ANTICPXSVR_BASECODE_ERROR + 0xA)
|
|
// 클라이언트 파일 변조가 감지되었습니다
|
|
#define ERROR_ANTICPXSVR_CLIENT_FILE_ATTACK (ANTICPXSVR_BASECODE_ERROR + 0xB)
|
|
// 메모리 변조가 감지되었습니다
|
|
#define ERROR_ANTICPXSVR_MEMORY_ATTACK (ANTICPXSVR_BASECODE_ERROR + 0xC)
|
|
// 구 버전 클라이언트 지원이 중지되었습니다
|
|
// (서버 중지 없이 HSB 파일을 업데이트하였을 경우 HSB 정책에 구 버전 클라이언트를 지원하지 않도록
|
|
// 설정되어 있을 경우 이 오류가 발생할 수 있다. 정책에 의한 것이므로 명백한 오류는 아니다.)
|
|
#define ERROR_ANTICPXSVR_OLD_VERSION_CLIENT_EXPIRED (ANTICPXSVR_BASECODE_ERROR + 0xD)
|
|
// HSB 파일을 생성할 때 지정한 핵쉴드 모듈과 짝이 맞지 않습니다
|
|
#define ERROR_ANTICPXSVR_UNKNOWN_CLIENT (ANTICPXSVR_BASECODE_ERROR + 0xE)
|
|
// V3 Small Engine 파일의 변조가 감지되었습니다.
|
|
#define ERROR_ANTICPXSVR_V3SENGINE_FILE_ATTACK (ANTICPXSVR_BASECODE_ERROR + 0xF)
|
|
// Nano Engine 파일의 변조가 감지되었습니다.
|
|
#define ERROR_ANTICPXSVR_NANOENGINE_FILE_ATTACK (ANTICPXSVR_BASECODE_ERROR + 0x10)
|
|
// HackShield Version이 지원되지 않는다.
|
|
#define ERROR_ANTICPXSVR_INVALID_HACKSHIELD_VERSION (ANTICPXSVR_BASECODE_ERROR + 0x11)
|
|
// Engine Version이 지원되지 않는다.
|
|
#define ERROR_ANTICPXSVR_INVALID_ENGINE_VERSION (ANTICPXSVR_BASECODE_ERROR + 0x12)
|
|
// 정의되지 않은 에러
|
|
#define ERROR_ANTICPXSVR_UNKNOWN (ANTICPXSVR_BASECODE_ERROR + 0xFF)
|
|
|
|
#ifndef UNIX
|
|
#ifdef AHNHS_EXPORTS
|
|
#define AHNHS_API __declspec(dllexport)
|
|
#else
|
|
#define AHNHS_API __declspec(dllimport)
|
|
#endif
|
|
#else
|
|
#define IN
|
|
#define OUT
|
|
#define __stdcall
|
|
#define AHNHS_API
|
|
#endif
|
|
|
|
typedef unsigned long AHNHS_SERVER_HANDLE;
|
|
typedef unsigned long AHNHS_CLIENT_HANDLE;
|
|
|
|
#ifndef __ANTICPX_TRANS_BUFFER__
|
|
#define __ANTICPX_TRANS_BUFFER__
|
|
|
|
#define ANTICPX_TRANS_BUFFER_MAX 400
|
|
|
|
// [2008.1.2][남성일][BT35349][AntiCpXSvr.dll 1.0.0.10 이후 부터 적용]
|
|
// 게임사에서 기본 bytealigment를 사용하지 않으면 핵쉴드 서버연동 모듈 적용 후 게임
|
|
// bytealignment가 변경되어 버그 발생할 수 있어 기존 정보를 스택에 저장.
|
|
#pragma pack(push) //기존 alignment 저장
|
|
#pragma pack(8)
|
|
|
|
typedef struct _AHNHS_TRANS_BUFFER
|
|
{
|
|
unsigned short nLength;
|
|
unsigned char byBuffer[ANTICPX_TRANS_BUFFER_MAX/* 송수신 패킷의 최대 크기 */];
|
|
|
|
} AHNHS_TRANS_BUFFER, *PAHNHS_TRANS_BUFFER;
|
|
|
|
#pragma pack(pop) // 기존 alignment 복구.
|
|
|
|
#endif // __ANTICPX_TRANS_BUFFER__
|
|
|
|
#if defined(__cplusplus)
|
|
extern "C"
|
|
{
|
|
#endif
|
|
|
|
/**
|
|
서버 핸들(Server Handle)을 생성한다
|
|
|
|
@param
|
|
const char *pszFilePath ; [입력값] HackShield Briefcase (.hsb) 파일 경로
|
|
|
|
@retval
|
|
서버 핸들(Server Handle)
|
|
|
|
@remarks
|
|
서버핸들을 올바르게 생성하지 못했을 경우 NULL 값을 리턴한다. 보통 HackShield Briefcase
|
|
(.hsb) 파일 경로가 올바르지 않을 경우나 시스템 리소스(메모리)가 부족할 경우 발생한다.
|
|
|
|
@see
|
|
확장 서버연동 Quick Guide를 참고해 주세요.
|
|
*/
|
|
AHNHS_API
|
|
AHNHS_SERVER_HANDLE
|
|
__stdcall
|
|
_AhnHS_CreateServerObject (
|
|
IN const char *pszFilePath
|
|
);
|
|
|
|
|
|
/**
|
|
서버 핸들(Server Handle)을 닫는다
|
|
|
|
@param
|
|
AHNHS_SERVER_HANDLE hServer ; [입력값] 서버 핸들(Server Handle)
|
|
|
|
@retval
|
|
없음
|
|
|
|
@remarks
|
|
생성한 서버핸들은 서버 프로세스나 서비스 프로세스가 종료할 때 닫아주어야
|
|
서버핸들 생성에 사용되었던 메모리나 시스템 자원을 해제하게된다.
|
|
|
|
@see
|
|
확장 서버연동 Quick Guide를 참고해 주세요.
|
|
*/
|
|
AHNHS_API
|
|
void
|
|
__stdcall
|
|
_AhnHS_CloseServerHandle (
|
|
IN AHNHS_SERVER_HANDLE hServer
|
|
);
|
|
|
|
|
|
/**
|
|
클라이언트 핸들(Client Handle)을 생성한다
|
|
|
|
@param
|
|
AHNHS_SERVER_HANDLE hServer ; [입력값] 서버 핸들(Server Handle)
|
|
|
|
@retval
|
|
클라이언트 핸들(Client Handle)
|
|
|
|
@remarks
|
|
서버 핸들을 입력 받아 클라이언트 핸들을 생성한다. 클라이언트 핸들은
|
|
클라이언트가 접속할 때 마다 생성하며, 세션이 유지되는 동안 핸들을 닫지 않고
|
|
재사용한다.
|
|
|
|
@see
|
|
확장 서버연동 Quick Guide를 참고해 주세요.
|
|
*/
|
|
AHNHS_API
|
|
AHNHS_CLIENT_HANDLE
|
|
_AhnHS_CreateClientObject (
|
|
IN AHNHS_SERVER_HANDLE hServer
|
|
);
|
|
|
|
|
|
/**
|
|
클라이언트 핸들(Client Handle)을 닫는다
|
|
|
|
@param
|
|
AHNHS_CLIENT_HANDLE hClient ; [입력값] 클라이언트 핸들(Client Handle)
|
|
|
|
@retval
|
|
없음
|
|
|
|
@remarks
|
|
생성한 클라이언트 핸들은 클라이언트 세션이 종료될 때 해제되어야 한다.
|
|
이때 클라이언트 핸들 생성에 사용되었던 메모리나 시스템 자원을 해제하게된다.
|
|
|
|
@see
|
|
확장 서버연동 Quick Guide를 참고해 주세요.
|
|
*/
|
|
AHNHS_API
|
|
void
|
|
__stdcall
|
|
_AhnHS_CloseClientHandle (
|
|
IN AHNHS_CLIENT_HANDLE hClient
|
|
);
|
|
|
|
|
|
/**
|
|
클라이언트의 해킹 시도를 감지하기 위해 요청(메시지)를 생성한다.
|
|
|
|
@param
|
|
AHNHS_CLIENT_HANDLE hClient ; [입력값] 클라이언트 핸들
|
|
PAHNHS_TRANS_BUFFER pRequestBuffer ; [출력값] 보낼 데이터 버퍼/길이
|
|
|
|
@retval
|
|
ERROR_ANTICPXSVR_xxx 형식으로 정의되어 있는 에러 코드
|
|
|
|
@remarks
|
|
현재 세션에 맞는 클라이언트 핸들을 입력하여 요청 메시지를 생성한다.
|
|
요청 메시지는 AHNHS_TRANS_BUFFER 구조체 형태로 출력되며, 멤버 변수 값은
|
|
다음과 같다.
|
|
|
|
typedef struct _AHNHS_TRANS_BUFFER
|
|
{
|
|
unsigned short nLength;
|
|
unsigned char byBuffer[ANTICPX_TRANS_BUFFER_MAX]; // 송수신 패킷의 최대 버퍼 크기
|
|
|
|
} AHNHS_TRANS_BUFFER, *PAHNHS_TRANS_BUFFER;
|
|
|
|
nLength ; 요청 메시지 생성에 사용된 버퍼 길이
|
|
byBuffer ; 요청 메시지 생성에 사용될 수 있는 최대 바이트 버퍼
|
|
|
|
주의 사항!!! byBuffer는 요청 메시지 생성에 사용될 수 있는 최대 버퍼 크기이므로 네트워크로
|
|
전송할 때 nLength 만큼만 전송해야한다.
|
|
|
|
Example:
|
|
|
|
AHNHS_TRANS_BUFFER stReqTransBuf;
|
|
|
|
ulRet = _AhnHS_MakeRequest ( hClient, &stReqTransBuf );
|
|
|
|
if ( ulRet != ERROR_SUCCESS )
|
|
return ulRet;
|
|
|
|
bytesSent = send( ConnectSocket, stReqTransBuf.byBuffer, stReqTransBuf.nLength, 0 );
|
|
|
|
...
|
|
|
|
@see
|
|
확장 서버연동 Quick Guide를 참고해 주세요.
|
|
*/
|
|
AHNHS_API
|
|
unsigned long
|
|
__stdcall
|
|
_AhnHS_MakeRequest (
|
|
IN AHNHS_CLIENT_HANDLE hClient,
|
|
OUT PAHNHS_TRANS_BUFFER pRequestBuffer
|
|
);
|
|
|
|
|
|
/**
|
|
클라이언트의 응답(메시지)이 올바른지 검사한다.
|
|
|
|
@param
|
|
AHNHS_CLIENT_HANDLE hClient ; [입력값] 클라이언트 핸들
|
|
unsigned char *pbyResponse ; 클라이언트로 부터 받은 데이터 버퍼
|
|
unsigned long nResponseLength ; 클라이언트로 부터 받은 데이터 길이
|
|
|
|
@retval
|
|
ERROR_ANTICPXSVR_xxx 형식으로 정의되어 있는 에러 코드
|
|
|
|
@remarks
|
|
_AhnHS_MakeRequest 함수를 통한 요청(메시지)에 대한 클라이언트의 응답이
|
|
올바른지 검사하는 함수이다.
|
|
|
|
@see
|
|
확장 서버연동 Quick Guide를 참고해 주세요.
|
|
*/
|
|
AHNHS_API
|
|
unsigned long
|
|
__stdcall
|
|
_AhnHS_VerifyResponse (
|
|
IN AHNHS_CLIENT_HANDLE hClient,
|
|
IN unsigned char *pbyResponse,
|
|
IN unsigned long nResponseLength
|
|
);
|
|
|
|
#if defined(__cplusplus)
|
|
}
|
|
#endif
|
|
|
|
#endif // _ANTICPX_SERVER_H_
|