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-terminated 문자열에 대한 포인터입니다. 이 주소는 IP 주소, 인터넷 호스트 이름("www.microsoft.com") 또는 NetBIOS 이름("products1")일 수 있습니다.
이 매개 변수가 NULL
[in] unnamedParam2
예약; 은 0이어야 합니다.
[in] unnamedParam3
lpszAddress 주소와 연결할 하나 이상의 RASAUTODIALENTRY 구조체의 배열에 대한 포인터입니다.
[in] unnamedParam4
lpAutoDialEntries 버퍼의 크기(바이트)를 지정합니다.
[in] unnamedParam5
lpAutoDialEntries 버퍼의 RASAUTODIALENTRY 구조체 수를 지정합니다.
반환 값
함수가 성공하면 반환 값이 ERROR_SUCCESS.
함수가 실패하면 반환 값은 다음 오류 코드 중 하나이거나 라우팅 및 원격 액세스 오류 코드 또는 Winerror.h의 값입니다.
| 값 | 의미 |
|---|---|
|
RASAUTODIALENTRY 구조체의 dwSize 멤버가 잘못된 값입니다. |
|
|
|
lpAutoDialEntries 지정된 연결 이름이 없습니다. |
발언
AutoDial 매핑 데이터베이스의 주소에는 여러 개의 연결된 RASAUTODIALENTRY 항목이 있을 수 있습니다. 각 항목은 특정 TAPI 전화 걸기 위치에 대한 AutoDial 정보를 지정합니다.
lpszAddress 주소가 데이터베이스에 없으면 RasSetAutodialAddress 데이터베이스에 주소를 추가합니다. lpAutoDialEntries 매개 변수는 새 주소와 연결할 AutoDial 항목을 지정합니다.
RAS는 로컬 컴퓨터에 대한 전역인 기본 인터넷 연결을 지원하며 각 사용자에 대한 기본 인터넷 연결을 지원합니다.
lpszAddress 매개 변수가 길이가 0인 문자열이고 lpAutoDialEntries 매개 변수가 하나의 항목으로 빈 연결 이름을 지정하는 경우 RasSetAutodialAddress 기본 인터넷 연결을 삭제합니다.
도메인이 아닌 클라이언트 컴퓨터에서 사용자가 연결을 기본 인터넷 연결로 설정하고 RASAUTODIALENTRY 구조의 szEntry 멤버에서 "모든 사용자용" 연결을 지정하는 경우 기본 인터넷 연결은 로컬 컴퓨터에서 전역적으로 설정됩니다. 다른 모든 경우에서는 컴퓨터의 각 사용자에 대해 기본 인터넷 연결이 개별적으로 설정됩니다.
하나는 "모든 사용자에 대한" 연결로 구성되고 다른 하나는 "for-me-only" 연결로 구성된 경우 이름이 같은 두 개의 연결을 가질 수 있습니다. lpAutoDialEntries 매개 변수가 전역 및 사용자별 연결에 해당하는 연결 이름을 지정하면 사용자별 연결이 설정됩니다.
메모
ras.h 헤더는 RAsSetAutodialAddress를 UNICODE 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows 2000 Server [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | ras.h |
| 라이브러리 | Rasapi32.lib |
| DLL | Rasapi32.dll |
참고 항목
RASAUTODIALENTRY
RAS(원격 액세스 서비스) 개요
원격 액세스 서비스 함수