Share via

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.

함수가 실패하면 반환 값은 다음 오류 코드 중 하나일 수 있습니다.

값 의미
ERROR_BUFFER_INVALID
 pBuffer 매개 변수에 전달된 버퍼에 대한 포인터가 잘못되었습니다.
ERROR_INVALID_PORT_HANDLE
 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

추가 정보

RAS 사용자 지정 스크립팅

RasCustomScriptExecute

RasSendBuffer