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
[in] unnamedParam2
전화 번호부에 있는 기존 항목의 이름을 지정하는 null종료된 문자열에 대한 포인터입니다.
[in] unnamedParam3
하위 엔트리의 1부터 시작하는 인덱스를 지정합니다. 인덱스가 기존 하위 엔트리 인덱스와 일치하는 경우 함수는 해당 하위 엔트리의 속성을 변경합니다. 인덱스가 기존 인덱스와 일치하지 않으면 함수는 새 하위 엔트리를 만듭니다.
[in] unnamedParam4
하위 엔터티의 데이터를 지정하는 RASSUBENTRY 구조체에 대한 포인터입니다.
구조 다음에 null-terminated 대체 전화 번호 문자열의 배열이 뒤따를 수 있습니다. 마지막 문자열은 두 개의 연속 null 문자로 종료됩니다. RASSUBENTRY 구조체의 dwAlternateOffset 멤버에는 첫 번째 문자열에 대한 오프셋이 포함됩니다.
[in] unnamedParam5
lpRasSubEntry 버퍼의 크기(바이트)를 지정합니다.
[in] unnamedParam6
TAPI 디바이스 구성 블록에 대한 포인터입니다. 이 매개 변수는 현재 사용되지 않습니다. 호출자는 이 매개 변수에 대해 NULL 전달해야 합니다. TAPI 디바이스 구성 블록에 대한 자세한 내용은 lineGetDevConfig
[in] unnamedParam7
TAPI 디바이스 구성 블록의 크기를 지정합니다. 이 매개 변수는 현재 사용되지 않습니다. 호출자는 이 매개 변수에 대해 0을 전달해야 합니다.
반환 값
함수가 성공하면 반환 값이 ERROR_SUCCESS.
함수가 실패하면 반환 값은 다음 오류 코드 중 하나이거나 라우팅 및 원격 액세스 오류 코드 또는 Winerror.h의 값입니다.
| 값 | 의미 |
|---|---|
|
lpRasEntry 지정한 주소 또는 버퍼가 잘못되었습니다. |
|
전화 번호부 항목이 없습니다. |
|
전화 번호부가 손상되었거나 구성 요소가 없습니다. |
|
잘못된 매개 변수를 사용하여 함수를 호출했습니다. |
발언
RAS 전화 번호부 항목에는 각각 디바이스와 전화 번호로 구성된 하위 엔트리가 0개 이상 있을 수 있습니다. 여러 하위 엔트리가 있는 전화 번호부 항목은 항목에 전화를 걸 때 사용 가능한 첫 번째 하위 엔트리 또는 모든 하위 엔트리로 전화를 걸도록 구성할 수 있습니다.
RasGetEntryProperties 함수를 사용하여 전화 번호부 항목의 하위 항목에 대한 정보를 포함하는 RASENTRY 구조를 검색합니다. dwSubEntries 멤버는 하위 엔티티 수를 나타내고 dwDialMode 멤버는 전화 걸기 구성을 나타냅니다.
메모
ras.h 헤더는 RAsSetSubEntryProperties를 UNICODE 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows 2000 Server [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | ras.h |
| 라이브러리 | Rasapi32.lib |
| DLL | Rasapi32.dll |
참고 항목
RASENTRY
RASSUBENTRY
RAS(원격 액세스 서비스) 개요
원격 액세스 서비스 함수