RasSetAutodialAddressA 함수(ras.h)

  • 아티클

RasSetAutodialAddress 함수는 AutoDial 매핑 데이터베이스에 주소를 추가할 수 있습니다. 또는 함수는 데이터베이스의 기존 주소와 연결된 데이터를 삭제하거나 수정할 수 있습니다.

구문

DWORD RasSetAutodialAddressA(
  [in] LPCSTR              unnamedParam1,
  [in] DWORD               unnamedParam2,
  [in] LPRASAUTODIALENTRYA unnamedParam3,
  [in] DWORD               unnamedParam4,
  [in] DWORD               unnamedParam5
);

매개 변수

[in] unnamedParam1

추가, 삭제 또는 수정할 주소를 지정하는 null로 끝나는 문자열에 대한 포인터입니다. 이 주소는 IP 주소, 인터넷 호스트 이름("www.microsoft.com") 또는 NetBIOS 이름("products1")일 수 있습니다.

이 매개 변수가 NULL인 경우 함수는 기본 인터넷 연결을 설정합니다(주의 참조). 이 매개 변수가 길이가 0인 문자열을 가리키는 경우 함수는 기본 인터넷 연결을 삭제합니다.

[in] unnamedParam2

예약; 는 0이어야 합니다.

[in] unnamedParam3

lpszAddress 주소와 연결할 하나 이상의 RASAUTODIALENTRY 구조체 배열에 대한 포인터입니다. lpAutoDialEntries가 NULL이고 dwcbAutoDialEntries가 0이면 RasSetAutodialAddress는 매핑 데이터베이스에서 lpszAddress와 연결된 모든 구조를 삭제합니다.

[in] unnamedParam4

lpAutoDialEntries 버퍼의 크기(바이트)를 지정합니다.

[in] unnamedParam5

lpAutoDialEntries 버퍼의 RASAUTODIALENTRY 구조체 수를 지정합니다.

반환 값

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

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

값 의미
ERROR_INVALID_SIZE
 RASAUTODIALENTRY 구조체의 dwSize 멤버가 잘못된 값입니다.
ERROR_INVALID_PARAMETER
 lpszAddress 매개 변수는 NULL입니다.
ERROR_CANNOT_FIND_PHONEBOOK_ENTRY
 lpAutoDialEntries에 지정된 연결 이름이 없습니다.

설명

AutoDial 매핑 데이터베이스의 주소에는 연결된 RASAUTODIALENTRY 항목이 있을 수 있습니다. 각 항목은 특정 TAPI 전화 걸기 위치에 대한 AutoDial 정보를 지정합니다.

lpszAddress 매개 변수로 지정된 주소가 데이터베이스의 기존 주소이고 lpAutoDialEntries 매개 변수가 NULL이 아닌 경우 RasSetAutodialAddress 함수는 주소와 연결된 AutoDial 항목 집합을 수정합니다. lpAutoDialEntries 배열의 항목이 주소에 이미 항목이 있는 전화 걸기 위치를 지정하는 경우 함수는 기존 항목을 새 항목으로 바꿉니다. 그렇지 않으면 함수는 주소의 항목 집합에 lpAutoDialEntries 항목을 추가하기만 하면 됩니다.

lpszAddress 주소가 데이터베이스에 있고 lpAutoDialEntries가 NULL이고 lpAutoDialEntries가 0이면 RasSetAutodialAddress가 데이터베이스에서 주소를 삭제합니다.

lpszAddress 주소가 데이터베이스에 없는 경우 RasSetAutodialAddress는 데이터베이스에 주소를 추가합니다. lpAutoDialEntries 매개 변수는 새 주소와 연결할 AutoDial 항목을 지정합니다.

RAS는 로컬 컴퓨터에 대한 전역인 기본 인터넷 연결을 지원하며 각 사용자에 대한 기본 인터넷 연결을 지원합니다.

lpszAddress 매개 변수가 NULL이고 lpAutoDialEntries 매개 변수가 하나의 항목이 있는 연결 이름을 지정하는 경우 RasSetAutodialAddress는 연결을 기본 인터넷 연결로 설정합니다. lpAutoDialEntries에 지정된 연결 이름이 이미 있어야 합니다. 그렇지 않으면 ERROR_CANNOT_FIND_PHONEBOOK_ENTRY 반환됩니다.

lpszAddress 매개 변수가 길이가 0인 문자열이고 lpAutoDialEntries 매개 변수가 하나의 항목으로 빈 연결 이름을 지정하면 RasSetAutodialAddress는 기본 인터넷 연결을 삭제합니다.

도메인이 아닌 클라이언트 컴퓨터에서 사용자가 연결을 기본 인터넷 연결로 설정하고 RASAUTODIALENTRY 구조의 szEntry 멤버에서 "모든 사용자용" 연결을 지정하려는 경우 기본 인터넷 연결은 로컬 컴퓨터에서 전역적으로 설정됩니다. 다른 모든 경우에서 기본 인터넷 연결은 컴퓨터의 각 사용자에 대해 개별적으로 설정됩니다.

하나의 연결이 "모든 사용자용" 연결로 구성되고 다른 연결이 "for-me-only" 연결로 구성된 경우 이름이 같은 두 개의 연결이 있을 수 있습니다. lpAutoDialEntries 매개 변수가 전역 및 사용자별 연결에 해당하는 연결 이름을 지정하는 경우 사용자별 연결이 설정됩니다.

참고

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

요구 사항

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

추가 정보

RASAUTODIALENTRY

RasEnumAutodialAddresses

RasGetAutodialAddress

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

원격 액세스 서비스 함수