PFNRASRECEIVEBUFFER 콜백 함수(ras.h)
사용자 지정 스크립팅 DLL은 RasReceiveBuffer 함수를 호출하여 RAS에 지정된 포트를 통해 서버에서 데이터를 받을 준비가 되었음을 알릴 수 있습니다.
PFNRASRECEIVEBUFFER 형식은 이 콜백 함수에 대한 포인터를 정의합니다. RasReceiveBuffer 는 애플리케이션 정의 함수 이름의 자리 표시자입니다.
구문
PFNRASRECEIVEBUFFER Pfnrasreceivebuffer;
DWORD Pfnrasreceivebuffer(
HANDLE hPort,
PBYTE pBuffer,
PDWORD pdwSize,
DWORD dwTimeOut,
HANDLE hEvent
)
{...}
매개 변수
hPort
데이터를 받을 포트에 대한 핸들입니다. 이 핸들은 RAS가 RasCustomScriptExecute 함수의 첫 번째 매개 변수로 전달한 핸들이어야 합니다.
pBuffer
hPort 매개 변수로 지정된 포트에서 데이터를 수신하는 버퍼에 대한 포인터입니다. RasGetBuffer 함수를 사용하여 이 버퍼를 가져옵니다.
pdwSize
pBuffer 매개 변수가 가리키는 버퍼에서 반환된 데이터의 크기를 수신하는 DWORD 변수에 대한 포인터입니다.
dwTimeOut
hEvent
받은 데이터를 사용할 수 있을 때 RAS가 신호를 보낼 이벤트 개체에 대한 핸들입니다.
반환 값
함수가 성공하면 반환 값이 ERROR_SUCCESS.
함수가 실패하면 반환 값은 다음 오류 코드 중 하나일 수 있습니다.
| 값 | 의미 |
|---|---|
|
pBuffer 매개 변수에 전달된 버퍼에 대한 포인터가 잘못되었습니다. |
|
hPort 매개 변수로 지정된 핸들이 잘못되었습니다. |
설명
RasReceiveBuffer 는 비동기 함수입니다. RasReceiveBuffer 는 데이터를 아직 사용할 수 없는 경우에도 즉시 반환합니다. 사용자 지정 스크립팅 DLL은 hEvent 매개 변수로 지정된 이벤트 개체를 기다려야 합니다. 데이터를 사용할 수 있는 경우 RAS는 이 이벤트에 신호를 보냅니다. 그런 다음 사용자 지정 스크립팅 DLL은 RasRetrieveBuffer 함수를 호출하여 데이터를 가져와야 합니다. 사용자 지정 스크립팅 DLL은 RasReceiveBuffer에서 전달한 것과 동일한 버퍼 포인터를 RasRetrieveBuffer에 전달할 수 있습니다.
또한 RAS는 데이터가 게시되기 전에 포트 연결이 끊어진 경우 이벤트 개체에 신호를 보냅니다. 이 경우 RasRetrieveBuffer 는 실패의 원인을 나타내는 Raserror.h에 정의된 오류를 반환합니다.
사용자 지정 스크립팅 DLL은 함수 포인터 를 통해 RasReceiveBuffer 를 호출합니다. RAS가 DLL의 RasCustomScriptExecute 구현을 호출할 때 함수 포인터가 매개 변수로 사용자 지정 스크립팅 DLL에 전달됩니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | ras.h |