RasSetSubEntryPropertiesA 함수(ras.h)

  • 아티클

RasSetSubEntryProperties 함수는 새 하위 엔트리를 만들거나 지정된 전화 번호부 항목의 기존 하위 엔토리를 수정합니다.

구문

DWORD RasSetSubEntryPropertiesA(
  [in] LPCSTR         unnamedParam1,
  [in] LPCSTR         unnamedParam2,
  [in] DWORD          unnamedParam3,
  [in] LPRASSUBENTRYA unnamedParam4,
  [in] DWORD          unnamedParam5,
  [in] LPBYTE         unnamedParam6,
  [in] DWORD          unnamedParam7
);

매개 변수

[in] unnamedParam1

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

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

[in] unnamedParam2

전화 번호부에 있는 기존 항목의 이름을 지정하는 null로 끝나는 문자열에 대한 포인터입니다.

[in] unnamedParam3

하위 엔트리의 1 기반 인덱스를 지정합니다. 인덱스가 기존 하위 엔트리 인덱스와 일치하는 경우 함수는 해당 하위 엔트리의 속성을 변경합니다. 인덱스가 기존 인덱스와 일치하지 않으면 함수는 새 하위 엔트리를 만듭니다.

[in] unnamedParam4

하위 엔터티에 대한 데이터를 지정하는 RASSUBENTRY 구조체에 대한 포인터입니다.

구조 다음에 null로 끝나는 대체 전화 번호 문자열 배열이 뒤따를 수 있습니다. 마지막 문자열은 두 개의 연속 null 문자로 종료됩니다. RASSUBENTRY 구조체의 dwAlternateOffset 멤버에는 첫 번째 문자열에 대한 오프셋이 포함됩니다.

[in] unnamedParam5

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

[in] unnamedParam6

TAPI 디바이스 구성 블록에 대한 포인터입니다. 이 매개 변수는 현재 사용되지 않습니다. 호출자는 이 매개 변수에 대해 NULL 을 전달해야 합니다. TAPI 디바이스 구성 블록에 대한 자세한 내용은 함수 lineGetDevConfig를 참조하세요.

[in] unnamedParam7

TAPI 디바이스 구성 블록의 크기를 지정합니다. 이 매개 변수는 현재 사용되지 않습니다. 호출자는 이 매개 변수에 대해 0을 전달해야 합니다.

반환 값

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

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

값 의미
ERROR_BUFFER_INVALID
 lpRasEntry로 지정된 주소 또는 버퍼가 잘못되었습니다.
ERROR_CANNOT_FIND_PHONEBOOK_ENTRY
 전화 번호부 항목이 없습니다.
ERROR_CANNOT_OPEN_PHONEBOOK
 전화 번호부가 손상되었거나 구성 요소가 누락되었습니다.
ERROR_INVALID_PARAMETER
 함수가 잘못된 매개 변수를 사용하여 호출되었습니다.

설명

RAS 전화 번호부 항목에는 각각 디바이스와 전화 번호로 구성된 하위 엔티티가 0개 이상 있을 수 있습니다. 여러 하위 엔티티가 있는 전화 번호부 항목은 항목에 전화를 걸 때 사용 가능한 첫 번째 하위 엔트리 또는 모든 하위 엔트리로 전화를 걸도록 구성할 수 있습니다.

RasGetEntryProperties 함수를 사용하여 전화 번호부 항목의 하위 엔트리에 대한 정보가 포함된 RASENTRY 구조를 검색합니다. dwSubEntries 멤버는 하위 엔티티 수를 나타내고 dwDialMode 멤버는 전화 걸기 구성을 나타냅니다.

참고

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

요구 사항

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

추가 정보

RASENTRY

RASSUBENTRY

RasGetEntryProperties

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

원격 액세스 서비스 함수