SNANLS(SNA National Language Support) FindFirstCodePage 함수는 지정된 조건을 충족하는 코드 페이지의 첫 번째 instance 찾고, 코드 페이지 정보를 매개 변수로 전달된 구조에 복사하고, FindNextCodePage 함수에 대한 후속 호출에 사용되는 핸들을 열고 반환합니다.
구문
const HANDLE WINAPI FindFirstCodePage(
DWORDdwEnumOption,
struct CodePage *pPage
);
매개 변수
dwEnumOption
제공된 매개 변수입니다. 코드 페이지가 충족해야 하는 조건 집합입니다. 이러한 조건은 SNANLS.h 포함 파일에 정의된 다음 값의 조합일 수 있습니다.
ENUM_CP_AVAILABLE(0x01)
코드 페이지가 설치되어 있으며 사용할 수 있습니다.
ENUM_CP_HOST(0x02)
코드 페이지는 호스트 코드 페이지입니다(예: EBCDIC).
ENUM_CP_EURO(0x04)
코드 페이지에는 유로 문자에 대한 지원이 포함되어 있습니다.
ENUM_CP_DBCS(0x08)
코드 페이지는 더블 바이트 문자 집합에 대한 것입니다.
ENUM_CP_MBCS(0x10)
코드 페이지는 혼합 바이트 문자 집합에 대한 것입니다.
ENUM_CP_SBCS(0x20)
코드 페이지는 단일 바이트 문자 집합에 대한 것입니다.
이러한 조합 중 일부는 SNANLS에서 사용하는 설치된 코드 페이지와 일치하지 않는 경우를 나타냅니다.
pPage
제공된 매개 변수 및 반환된 매개 변수입니다. 코드 페이지 정보를 복사해야 하는 구조체 CodePage에 대한 포인터입니다.
반환이 성공하면 이 매개 변수가 가리키는 메모리 위치가 dwEnumOption의 조건을 충족하는 첫 번째 코드 페이지에 대한 정보로 채워집니다. 실패 시 이 매개 변수가 가리키는 메모리는 변경되지 않습니다.
CodePage 구조체는 SNANLS에 정의되어 있습니다. H 포함 파일은 다음과 같습니다.
struct CodePage {
BYTE CodePageKey;
DWORD CodePageID;
WCHAR szFriendlyName[CP_SIZE];
short eGroup;
BOOL bAvailable;
BYTE bccsid;
BOOL bEuro;
};
이 CodePage 구조체의 멤버는 다음과 같습니다.
CodePageKey
CodePage 구조체의 배열에 대한 인덱스를 나타내는 숫자 값입니다. 이 값은 추가 코드 페이지가 지원될 때 서비스 팩에서 임의로 변경할 수 있으므로 불투명 값으로 사용해야 합니다.
CodePageID
NLS 코드 페이지 번호입니다.
szFriendlyName
이 코드 페이지의 SNANLS 표시 이름입니다.
eGroup
이 코드 페이지가 나타내는 그룹입니다. . 이 값은 코드 그룹에 대한 SNANLS.h 포함 파일에 정의된 다음 열거형 중 하나일 수 있습니다.
ENUM_CP_EBCDIC
이 코드 페이지는 EBCDIC 코드 페이지 그룹의 멤버입니다.
ENUM_CP_ANSI
이 코드 페이지는 ANSI 코드 페이지 그룹의 구성원입니다.
ENUM_CP_ISO
이 코드 페이지는 ISO 코드 페이지 그룹의 구성원입니다.
ENUM_CP_OEMPC
이 코드 페이지는 OEM PC 코드 페이지 그룹의 구성원입니다.
ENUM_CP_ISO
이 코드 페이지는 ISO 코드 페이지 그룹의 구성원입니다.
ENUM_CP_ISO
이 코드 페이지는 ISO 코드 페이지 그룹의 구성원입니다.
ENUM_CP_OEM PC
이 코드 페이지는 OEM PC 코드 페이지 그룹의 구성원입니다.
ENUM_CP_OPEN
이 코드 페이지는 Open Systems 코드 페이지 그룹의 구성원입니다.
ENUM_CP_UCS
이 코드 페이지는 UCS 코드 페이지 그룹의 구성원입니다.
bAvailable
이 코드 페이지가 컴퓨터에 설치되었음을 나타내는 데 사용되는 부울입니다. 이 멤버에 대한 FALSE 값은 이 코드 페이지가 설치되어 있는지 확인하기 위해 컴퓨터를 쿼리하지 않음을 나타냅니다. TRUE 값은 코드 페이지가 설치되었음을 나타냅니다.
bccsid
코드 페이지의 형식을 나타내는 데 사용되는 플래그입니다. 이 플래그는 다음 중 하나일 수 있습니다.
ENUM_CP_DBCS(0x08)
코드 페이지는 더블 바이트 문자 집합에 대한 것입니다.
ENUM_CP_MBCS(0x10)
코드 페이지는 혼합 바이트 문자 집합에 대한 것입니다.
ENUM_CP_SBCS(0x20)
코드 페이지는 단일 바이트 문자 집합에 대한 것입니다.
bEuro
이 코드 페이지에서 유로 기호를 지원하는지 여부를 나타내는 데 사용되는 부울 값입니다. 이 값이 TRUE이면 유로 기호가 지원됩니다.
반환 값
FindFirstCodePage 함수는 성공하면 FindNextCodePage 또는 FindCloseCodePage 호출에 사용되는 핸들을 반환합니다. 실패하면 이 핸들의 값에 대해 INVALID_HANDLE_VALUE 반환됩니다.
설명
이 함수에서 반환된 핸들은 사용자가 변조해서는 안 됩니다.
이 함수는 호스트 통합 서버의 SNANLS에서 지원됩니다.