PFNRASRETRIEVEBUFFER 콜백 함수(ras.h)

  • 아티클

사용자 지정 스크립팅 DLL은 RasRetrieveBuffer 함수를 호출하여 지정된 포트를 통해 RAS 서버에서 받은 데이터를 가져옵니다. 사용자 지정 스크립팅 DLL은 RAS가 RasReceiveBuffer 호출에 전달된 이벤트 개체에 신호를 보낸 후에만 RasRetrieveBuffer를 호출해야 합니다.

PFNRASRETRIEVEBUFFER 형식은 이 콜백 함수에 대한 포인터를 정의합니다. RasRetrieveBuffer 는 애플리케이션 정의 함수 이름의 자리 표시자입니다.

구문

PFNRASRETRIEVEBUFFER Pfnrasretrievebuffer;

DWORD Pfnrasretrievebuffer(
  HANDLE hPort,
  PBYTE pBuffer,
  PDWORD pdwSize
)
{...}

매개 변수

hPort

데이터를 받을 포트에 대한 핸들입니다. 이 핸들은 RAS가 RasCustomScriptExecute 함수의 첫 번째 매개 변수로 전달한 핸들이어야 합니다.

pBuffer

hPort 매개 변수로 지정된 포트에서 데이터를 수신하는 버퍼에 대한 포인터입니다. RasGetBuffer 함수를 사용하여 이 버퍼를 가져옵니다. 이 매개 변수의 값은 RasReceiveBuffer 함수에 전달된 버퍼에 대한 포인터와 같을 수 있습니다.

pdwSize

pBuffer 매개 변수가 가리키는 버퍼에서 반환된 데이터의 크기를 수신하는 DWORD 변수에 대한 포인터입니다.

반환 값

함수가 성공하면 반환 값이 ERROR_SUCCESS.

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

값 의미
ERROR_BUFFER_INVALID
 pBuffer 매개 변수에 전달된 버퍼에 대한 포인터가 잘못되었습니다.
ERROR_INVALID_PORT_HANDLE
 hPort 매개 변수로 지정된 핸들이 잘못되었습니다.
 

RAS는 데이터가 게시되기 전에 어떤 이유로 인해 포트 연결이 끊어지면 이벤트 개체에 신호를 보냅니다. 이 경우 RasRetrieveBuffer 는 실패의 원인을 나타내는 Raserror.h에 정의된 오류를 반환합니다.

설명

RasRetrieveBuffer 함수는 동기적입니다. 이 매개 변수가 반환되면 pBuffer 매개 변수가 가리키는 버퍼에 지정된 포트를 통해 수신된 데이터가 포함됩니다. 사용자 지정 스크립팅 DLL은 RAS가 이벤트 개체에 DLL이 RasReceiveBuffer 호출에 전달되었음을 알린 후에만 RasRetrieveBuffer를 호출해야 합니다.

사용자 지정 스크립팅 DLL은 함수 포인터 를 통해 RasRetrieveBuffer 를 호출합니다. RAS가 DLL의 RasCustomScriptExecute 구현을 호출할 때 함수 포인터가 매개 변수로 사용자 지정 스크립팅 DLL에 전달됩니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 ras.h

추가 정보

RAS 사용자 지정 스크립팅

RasCustomScriptExecute

RasReceiveBuffer

RasSendBuffer