RasCustomScriptExecuteFn 콜백 함수(ras.h)

아티클
08/25/2023

RAS는 RASEO_CustomScript 옵션이 설정된 전화 번호부 항목에 대한 연결을 설정할 때 RasCustomScriptExecute 함수를 호출합니다.

구문

RasCustomScriptExecuteFn Rascustomscriptexecutefn;

DWORD Rascustomscriptexecutefn(
  [in] HANDLE hPort,
  [in] LPCWSTR lpszPhonebook,
  [in] LPCWSTR lpszEntryName,
  [in] PFNRASGETBUFFER pfnRasGetBuffer,
  [in] PFNRASFREEBUFFER pfnRasFreeBuffer,
  [in] PFNRASSENDBUFFER pfnRasSendBuffer,
  [in] PFNRASRECEIVEBUFFER pfnRasReceiveBuffer,
  [in] PFNRASRETRIEVEBUFFER pfnRasRetrieveBuffer,
  [in] HWND hWnd,
  [in] RASDIALPARAMS *pRasDialParams,
       PVOID pvReserved
)
{...}

매개 변수

[in] hPort

연결이 설정된 포트에 대한 핸들입니다. 포트에서 데이터를 보내거나 받을 때 이 핸들을 사용합니다.

[in] lpszPhonebook

연결 항목이 있는 전화 번호부의 경로가 포함된 유니코드 문자열에 대한 포인터입니다.

[in] lpszEntryName

연결을 설정하기 위해 전화를 건 항목의 이름을 포함하는 유니코드 문자열에 대한 포인터입니다.

[in] pfnRasGetBuffer

PFNRASGETBUFFER 형식의 함수에 대한 포인터입니다. 사용자 지정 스크립팅 DLL은 이 함수를 사용하여 서버에 데이터를 보내기 위해 메모리를 할당해야 합니다.

[in] pfnRasFreeBuffer

PFNRASFREEBUFFER 형식의 함수에 대한 포인터입니다. 사용자 지정 스크립팅 DLL은 이 함수를 사용하여 pfnRasGetBuffer 함수에 의해 할당된 메모리를 해제해야 합니다.

[in] pfnRasSendBuffer

PFNRASSENDBUFFER 형식의 함수에 대한 포인터입니다. 사용자 지정 스크립팅 DLL은 이 함수를 사용하여 지정된 포트를 통해 서버와 통신합니다.

[in] pfnRasReceiveBuffer

PFNRASRECEIVEBUFFER 형식의 함수에 대한 포인터입니다. 사용자 지정 스크립팅 DLL은 이 함수를 사용하여 지정된 포트를 통해 서버와 통신합니다.

[in] pfnRasRetrieveBuffer

PFNRASRETRIEVEBUFFER 형식의 함수에 대한 포인터입니다. 사용자 지정 스크립팅 DLL은 이 함수를 사용하여 지정된 포트를 통해 서버와 통신합니다.

[in] hWnd

사용자 지정 스크립팅 DLL이 사용자에게 사용자 인터페이스를 제공하는 데 사용할 수 있는 창에 대한 핸들입니다.

[in] pRasDialParams

유니코드 RASDIALPARAMS 구조체 에 대한 포인터입니다. 이 구조에는 사용자의 인증 자격 증명이 포함됩니다. 사용자 지정 스크립팅 DLL은 이 구조체 의 szUserName, szPassword 및 szDomain 멤버를 수정할 수 있습니다. PPP(Point-to-Point Protocol)는 RasCustomScriptExecute 가 반환될 때 이러한 멤버에 저장된 모든 것을 사용합니다.

pvReserved

반환 값

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

함수가 실패하면 반환 값은 Winerror.h 또는 Raserror.h의 적절한 오류 코드여야 합니다.

설명

RAS 가 RasCustomScriptExecute를 호출하면 pRasDialParams 매개 변수가 유니코드 RASDIALPARAMS 구조를 가리킵니다. 즉, 구조체에는 유니코드 문자열만 포함됩니다.

경우에 따라 RASDIALPARAMS 구조체의 szUserName은 빈 문자열이 됩니다. 이러한 경우 사용자 지정 스크립팅 DLL은 GetUserName 함수의 유니코드 버전을 사용하여 현재 사용자의 이름을 가져와야 합니다.

요구 사항

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