RasGetEntryDialParamsA 함수(ras.h)

아티클
11/20/2024

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

요구 사항

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