RasGetEntryDialParamsA 함수(ras.h)

아티클
03/15/2023

RasGetEntryDialParams 함수는 지정된 전화 번호부 항목에 대한 RasDial 또는 RasSetEntryDialParams 함수에 대한 마지막으로 성공한 호출에 의해 저장된 연결 정보를 검색합니다.

구문

DWORD RasGetEntryDialParamsA(
  [in]      LPCSTR           unnamedParam1,
  [in, out] LPRASDIALPARAMSA unnamedParam2,
  [out]     LPBOOL           unnamedParam3
);

매개 변수

[in] unnamedParam1

전화 번호부(PBK) 파일의 전체 경로 및 파일 이름을 지정하는 null로 끝나는 문자열에 대한 포인터입니다. 이 매개 변수가 NULL인 경우 함수는 현재 기본 전화 번호부 파일을 사용합니다. 기본 전화 번호부 파일은 전화 접속 네트워킹 대화 상자의 사용자 기본 설정 속성 시트에서 사용자가 선택한 파일입니다.

Windows Me/98/95: 이 매개 변수는 항상 NULL이어야 합니다. 전화 접속 네트워킹은 전화 번호부 파일이 아닌 레지스트리에 전화 번호부 항목을 저장합니다.

[in, out] unnamedParam2

RASDIALPARAMS 구조체에 대한 포인터입니다.

입력 시 dwSize 멤버는 RASDIALPARAMS 구조체의 크기를 지정하고 szEntryName 멤버는 유효한 전화 번호부 항목을 지정합니다.

출력 시 구조체는 지정된 전화 번호부 항목과 연결된 연결 매개 변수를 받습니다.

구조체 의 szPhoneNumber 멤버는 전화 번호부 항목과 연결된 전화 번호를 받지 않습니다. 전화 번호부 항목과 연결된 전화 번호를 얻으려면 RasGetEntryProperties 함수를 호출합니다. szPhoneNumber가 RasDial에 전달된 RASDIALPARAMS 구조의 빈 문자열인 경우 RasDial은 전화 번호부 항목에 저장된 전화 번호를 사용합니다.

RASDIALPARAMS 구조체의 szPassword 멤버는 실제 암호를 반환하지 않습니다. 대신 szPassword 에는 저장된 암호에 대한 핸들이 포함되어 있습니다. RasSetEntryDialParams 및 RasDial에 대한 후속 호출에서 저장된 암호로 이 핸들을 대체합니다. 이 핸들이 표시되면 RasDial 은 저장된 암호를 검색하고 사용합니다. 이 핸들의 값은 운영 체제의 이후 버전에서 변경될 수 있습니다. 이 값의 내용이나 형식에 따라 달라지는 코드를 개발하지 마세요.

Windows NT 및 Windows Me/98/95: 보안 암호 기능은 지원되지 않습니다.

[out] unnamedParam3

함수가 전화 번호부 항목의 사용자 이름과 연결된 암호를 검색했는지 여부를 나타내는 플래그에 대한 포인터입니다. 시스템에서 지정된 항목에 대한 암호를 저장한 경우 lpfPassword 매개 변수는 TRUE 입니다. 시스템에 이 항목에 대해 저장된 암호가 없는 경우 lpfPassword 는 FALSE입니다.

Windows NT 및 Windows Me/98/95: lprasdialparams가 가리키는 RASDIALPARAMS 구조체의 szPassword 멤버에서 사용자의 암호가 반환된 경우 함수는 이 플래그를 TRUE로 설정합니다.

반환 값

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

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

값	설명
ERROR_BUFFER_INVALID	lprasdialparams 또는 lpfPassword 포인터가 잘못되었거나 lprasdialparams 버퍼가 잘못되었습니다.
ERROR_CANNOT_OPEN_PHONEBOOK	전화 번호부가 손상되었거나 구성 요소가 누락되었습니다.
ERROR_CANNOT_FIND_PHONEBOOK_ENTRY	전화 번호부 항목이 없습니다.

설명

참고

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

요구 사항


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