RasSecurityDialogBegin 함수(rasshost.h)
RasSecurityDialogBegin 함수는 원격 사용자가 연결을 시도할 때 RAS 서버가 호출하는 타사 RAS 보안 DLL 진입점입니다. 이렇게 하면 보안 DLL이 원격 사용자의 인증을 시작할 수 있습니다.
구문
DWORD RasSecurityDialogBegin(
[in] HPORT hPort,
[in] PBYTE pSendBuf,
[in] DWORD SendBufSize,
[in] PBYTE pRecvBuf,
[in] DWORD RecvBufSize,
VOID(* )(SECURITY_MESSAGE *) RasSecurityDialogComplete
);
매개 변수
[in] hPort
RAS 포트 핸들을 지정합니다. 보안 DLL은 RasSecurityDialogSend 및 RasSecurityDialogReceive와 같은 다른 RAS 보안 함수에서 이 핸들을 사용하여 이 인증 트랜잭션을 식별합니다.
이 핸들은 RAS 보안 함수에서만 유효합니다. 다른 I/O 함수에서는 사용하지 마세요.
[in] pSendBuf
RAS 서버에서 할당한 버퍼에 대한 포인터입니다. 보안 DLL은 RasSecurityDialogSend 함수와 함께 이 버퍼를 사용하여 원격 컴퓨터의 RAS 터미널 창에 표시되는 텍스트를 보냅니다.
[in] SendBufSize
pSendBuf 버퍼의 크기(바이트)를 지정합니다.
[in] pRecvBuf
RAS 서버에서 할당한 버퍼에 대한 포인터입니다. 보안 DLL은 RasSecurityDialogReceive 함수와 함께 이 버퍼를 사용하여 원격 사용자로부터 응답을 받습니다.
[in] RecvBufSize
pRecvBuf 버퍼의 크기(바이트)를 지정합니다.
RasSecurityDialogComplete
반환 값
보안 DLL이 인증 작업을 성공적으로 시작하면 RasSecurityDialogBegin 은 NO_ERROR 반환해야 합니다. 이 경우 보안 DLL은 나중에 RasSecurityDialogComplete 매개 변수가 가리키는 함수를 호출하여 인증 트랜잭션을 종료해야 합니다.
오류가 발생하면 RasSecurityDialogBegin 은 0이 아닌 오류 코드를 반환해야 합니다. 이 경우 RAS 서버는 호출을 중단하고 이벤트 로그에 오류를 기록합니다. 0이 아닌 오류 코드를 반환하면 인증 트랜잭션이 종료되므로 보안 DLL은 RasSecurityDialogComplete 함수를 호출할 필요가 없습니다.
설명
RAS 서버가 원격 컴퓨터에서 호출을 받으면 등록된 RAS 보안 DLL에서 내보낸 RasSecurityDialogBegin 함수를 호출합니다(있는 경우). RAS 서버가 이 함수를 호출하면 보안 DLL에 다음 정보를 전달합니다.
- 연결을 식별하는 포트 핸들
- 원격 사용자와 통신할 때 사용할 버퍼에 대한 포인터
- 인증이 완료되었을 때 호출할 RasSecurityDialogComplete 함수에 대한 포인터입니다.
RAS 서버가 차단되고 RasSecurityDialogBegin 이 반환될 때까지 다른 호출을 수락할 수 없으므로 RasSecurityDialogBegin 구현은 가능한 한 빨리 반환해야 합니다. RasSecurityDialogBegin 함수는 입력 매개 변수를 복사하고 원격 사용자와 통신하고 인증할 스레드를 만들어야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | rasshost.h |