RasGetAutodialAddressA 함수(ras.h)

  • 아티클

RasGetAutodialAddress 함수는 AutoDial 매핑 데이터베이스의 네트워크 주소와 연결된 모든 AutoDial 항목에 대한 정보를 검색합니다.

구문

DWORD RasGetAutodialAddressA(
  [in]      LPCSTR              unnamedParam1,
  [in]      LPDWORD             unnamedParam2,
  [in, out] LPRASAUTODIALENTRYA unnamedParam3,
  [in, out] LPDWORD             unnamedParam4,
  [out]     LPDWORD             unnamedParam5
);

매개 변수

[in] unnamedParam1

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

이 매개 변수가 NULL이면 함수는 기본 인터넷 연결을 검색합니다. 함수는 구성된 경우 사용자별 기본 인터넷 연결을 반환합니다. 그렇지 않으면 함수는 전역 기본 인터넷 연결을 반환합니다. 기본 인터넷 연결이 구성되지 않은 경우 함수는 lpdwcbAutoDialEntries 및 lpdwcAutoDialEntries 매개 변수에 대해 0 을 반환합니다 .

[in] unnamedParam2

예약; 은 NULL이어야 합니다.

[in, out] unnamedParam3

출력 시 lpszAddress 매개 변수에 지정된 주소와 연결된 각 AutoDial 항목에 대해 하나씩 RASAUTODIALENTRY 구조체 배열을 수신하는 버퍼에 대한 포인터입니다.

입력 시 버퍼의 첫 번째 RASAUTODIALENTRY 구조체의 dwSize 멤버를 sizeof(RASAUTODIALENTRY)로 설정하여 구조체의 버전을 식별합니다.

lpAutoDialEntries가 NULL인 경우 RasGetAutodialAddress는 lpdwcbAutoDialEntries 및 lpdwcAutoDialEntries 매개 변수를 설정하여 필요한 버퍼 크기(바이트) 및 AutoDial 항목 수를 나타냅니다.

[in, out] unnamedParam4

입력 시 lpAutoDialEntries 버퍼의 크기(바이트)를 지정하는 변수에 대한 포인터입니다.

출력에서 이 변수는 반환된 바이트 수 또는 버퍼가 너무 작은 경우 필요한 바이트 수를 받습니다.

[out] unnamedParam5

lpAutoDialEntries 버퍼에 반환된 구조 요소의 수를 수신하는 변수에 대한 포인터입니다.

반환 값

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

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

값 의미
ERROR_INVALID_SIZE
 RASAUTODIALENTRY 구조체의 dwSize 멤버가 잘못된 값입니다.
ERROR_INVALID_PARAMETER
 lpszAddress, lpdwcbAutoDialEntries 또는 lpdwcAutoDialEntries 매개 변수는 NULL입니다.

설명

RAS(원격 액세스 서비스)는 기본 인터넷 연결을 지원합니다. RAS는 로컬 컴퓨터에 대한 전역인 기본 인터넷 연결을 지원하며, 또한 각 사용자에 대한 기본 인터넷 연결을 지원합니다.

전역 기본 인터넷 연결의 이름은 다음 레지스트리 키 아래의 레지스트리에 저장됩니다.

HKEY_LOCAL_MACHINE
   Software
      Microsoft
         Ras Autodial
            Default

연결 이름을 저장하는 값은 다음과 같습니다.

DefaultInternet

이 값은 REG_SZ 형식입니다.

전역 기본 인터넷 연결은 Connections 폴더 사용자 인터페이스에서 모든 사용자 연결에 대해 로 구성되어야 합니다.

사용자별 기본 인터넷 연결의 이름은 다음 레지스트리 키 아래의 레지스트리에 저장됩니다.

Hkey_current_user\소프트웨어\Microsoft\Ras Autodial\기본

연결 이름을 저장하는 값은 다음과 같습니다.

DefaultInternet

이 값은 REG_SZ 형식입니다.

참고

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

요구 사항

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

추가 정보

RASAUTODIALENTRY

RasEnumAutodialAddresses

RasSetAutodialAddress

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

원격 액세스 서비스 함수