RasSetEntryDialParamsA 함수(ras.h)

아티클
11/20/2024

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의 값입니다.

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

발언

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

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

메모

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

요구 사항

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