RasSetEntryDialParamsA 함수(ras.h)

아티클
08/25/2023

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

구문

DWORD RasSetEntryDialParamsA(
  [in] LPCSTR           unnamedParam1,
  [in] LPRASDIALPARAMSA unnamedParam2,
  [in] BOOL             unnamedParam3
);

매개 변수

[in] unnamedParam1

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

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

[in] unnamedParam2

전화 번호부 항목과 연결할 연결 매개 변수를 지정하는 RASDIALPARAMS 구조체에 대한 포인터입니다. RasSetEntryDialParams는 다음과 같이 구조체의 멤버를 사용합니다.

멤버	의미
dwSize	구조체의 버전을 식별하려면 크기(RASDIALPARAMS)를 지정해야 합니다.
szEntryName	매개 변수를 설정할 전화 번호부 항목을 식별하는 null로 끝나는 문자열입니다.
szPhoneNumber	사용되지 않습니다. NULL로 설정합니다.
szCallbackNumber	콜백 전화 번호를 포함하는 null로 끝나는 문자열입니다. szCallbackNumber가 빈 문자열( "" )인 경우 콜백 번호는 변경되지 않습니다.
szUserName	이 항목과 연결된 사용자의 로그온 이름을 포함하는 null로 끝나는 문자열입니다. szUserName이 빈 문자열인 경우 사용자 이름은 변경되지 않습니다.
szPassword	szUserName으로 지정된 사용자의 암호를 포함하는 null로 끝나는 문자열입니다. szUserName이 빈 문자열인 경우 암호는 변경되지 않습니다. szPassword가 빈 문자열이고 fRemovePassword가 FALSE이면 암호가 빈 문자열로 설정됩니다. fRemovePassword가 TRUE이면 szPassword 문자열의 내용에 관계없이 szUserName으로 지정된 사용자의 이 전화 번호부 항목에 저장된 암호가 제거됩니다. Windows NT 4.0: szUserName이 빈 문자열인지 여부에 관계없이 암호가 szPassword에 지정된 문자열로 변경됩니다. Windows XP/2000: szPassword에 RasGetCredentials 또는 RasGetEntryDialParams에서 반환된 암호 핸들이 포함된 경우 RasSetEntryDialParams는 현재 저장된 암호를 변경하지 않고 성공적으로 반환됩니다.
szDomain	로그온할 도메인의 이름을 포함하는 null로 끝나는 문자열입니다. szDomain이 빈 문자열인 경우 도메인 이름은 변경되지 않습니다.
dwSubEntry	연결을 설정할 때 전화를 걸 초기 하위 엔티티의 (1 기반) 인덱스를 지정합니다.
dwCallbackId	RAS가 RasDialFunc2 콜백 함수에 전달하는 애플리케이션 정의 값을 지정합니다.

[in] unnamedParam3

lprasdialparams-szUserName>으로 표시된 사용자의 전화 번호부 항목의 저장된 암호를 제거할지 여부를 지정합니다. fRemovePassword가 TRUE이면 암호가 제거됩니다. fRemovePassword를 TRUE로 설정하는 것은 전화 접속 네트워킹에서 "암호 저장 취소" 검사 확인란을 확인하는 것과 같습니다. 전화 번호부 항목의 암호 또는 기타 속성을 설정할 때 fRemovePassword 를 FALSE로 설정합니다.

반환 값

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

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

값	Description
ERROR_BUFFER_INVALID	lprasdialparams로 지정된 주소 또는 버퍼가 잘못되었습니다.
ERROR_CANNOT_OPEN_PHONEBOOK	전화 번호부가 손상되었거나 구성 요소가 누락되었습니다.
ERROR_CANNOT_FIND_PHONEBOOK_ENTRY	전화 번호부 항목이 없습니다.

설명

새 전화 번호부 항목을 만들려면 RasSetEntryProperties 함수를 사용합니다.

Windows XP 이상: RasSetEntryDialParams 함수를 사용하지 마세요. 전화 번호부 항목에 대한 자격 증명을 설정하려면 RasSetCredentials 함수를 사용합니다. RasDial 함수에 매개 변수로 전달된 RASDIALPARAMS 구조체에서 RASDIALPARAMS의 자격 증명이 아닌 멤버(예: szCallbackNumber, dwSubEntry 또는 dwCallbackId)를 직접 설정합니다.

참고

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

요구 사항

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