RasCustomScriptExecuteFn 콜백 함수(ras.h)
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 |