RasGetAutodialParamA 함수(ras.h)

  • 아티클

RasGetAutodialParam 함수는 AutoDial 매개 변수의 값을 검색합니다.

구문

DWORD RasGetAutodialParamA(
  [in]      DWORD   unnamedParam1,
  [out]     LPVOID  unnamedParam2,
  [in, out] LPDWORD unnamedParam3
);

매개 변수

[in] unnamedParam1

검색할 AutoDial 매개 변수를 지정합니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값 의미
RASADP_DisableConnectionQuery
 lpvValue 매개 변수는 DWORD 값을 반환합니다. 이 값이 0(기본값)이면 AutoDial은 연결을 만들기 전에 사용자를 쿼리하는 대화 상자를 표시합니다. 이 값이 1이고 AutoDial 데이터베이스에 전화를 걸 전화 번호부 항목이 있는 경우 AutoDial은 대화 상자를 표시하지 않고 연결을 만듭니다.
RASADP_LoginSessionDisable
 lpvValue 매개 변수는 DWORD 값을 반환합니다. 이 값이 1이면 시스템에서 현재 로그온 세션에 대한 모든 AutoDial 연결을 사용하지 않도록 설정합니다. 이 값이 0(기본값)이면 AutoDial 연결이 사용하도록 설정됩니다. AutoDial 시스템 서비스는 새 사용자가 워크스테이션에 로그온할 때 이 값을 0으로 변경합니다.
RASADP_SavedAddressesLimit
 lpvValue 매개 변수는 AutoDial이 레지스트리에 저장하는 최대 주소 수를 나타내는 DWORD 값을 반환합니다. AutoDial은 먼저 AutoDial 연결을 만드는 데 사용한 주소를 저장합니다. 그런 다음 RAS 연결을 만든 후 학습한 주소를 저장합니다. RasSetAutodialAddress 함수를 사용하여 작성된 주소는 항상 저장되며 제한을 계산하는 데 포함되지 않습니다. 기본값은 100입니다.
RASADP_FailedConnectionTimeout
 lpvValue 매개 변수는 시간 제한 값을 나타내는 DWORD 값을 초 단위로 반환합니다. AutoDial 연결 시도가 실패하면 AutoDial 시스템 서비스는 제한 시간 동안 동일한 주소에 도달하려는 후속 시도를 사용하지 않도록 설정합니다. 이렇게 하면 AutoDial이 애플리케이션에서 동일한 논리 요청에 대해 여러 연결 대화 상자를 표시하지 않습니다. 기본값은 5입니다.
RASADP_ConnectionQueryTimeout
 lpvValue 매개 변수는 시간 제한 값을 나타내는 DWORD 값을 초 단위로 가리킵니다. AutoDial 연결을 시도하기 전에 시스템에서 사용자에게 시스템이 전화를 걸어야 하는지 확인하는 대화 상자가 표시됩니다. 대화 상자에는 사용자가 아무 작업도 수행하지 않는 경우 "다이얼 안 함" 선택으로 대화 상자를 종료하는 카운트다운 타이머가 있습니다. lpvValue에서 가리키는 DWORD 값은 이 카운트다운 타이머의 초기 시간을 지정합니다.

[out] unnamedParam2

지정된 매개 변수의 값을 받는 버퍼에 대한 포인터입니다.

[in, out] unnamedParam3

DWORD 값에 대한 포인터입니다.

입력 시 lpvValue 버퍼의 크기(바이트)를 나타내도록 이 값을 설정합니다.

출력에서 이 값은 버퍼에 기록된 값의 실제 크기를 나타냅니다.

반환 값

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

함수가 실패하면 반환 값은 다음 오류 코드 중 하나이거나 라우팅 및 원격 액세스 오류 코드 또는 Winerror.h의 값입니다.

값 의미
ERROR_INVALID_PARAMETER
 dwKey 또는 lpvValue 매개 변수가 잘못되었습니다.
ERROR_INVALID_SIZE
 lpdwcbValue에서 지정한 크기가 너무 작습니다.

설명

참고

ras.h 헤더는 RAsGetAutodialParam을 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

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

추가 정보

RasSetAutodialAddress

RasSetAutodialParam

RAS(원격 액세스 서비스) 개요

원격 액세스 서비스 함수