GetTextCharsetInfo 함수(wingdi.h)

현재 지정된 디바이스 컨텍스트로 선택된 글꼴의 문자 집합에 대한 정보를 검색합니다.

구문

int GetTextCharsetInfo(
  [in]            HDC             hdc,
  [out, optional] LPFONTSIGNATURE lpSig,
  [in]            DWORD           dwFlags
);

매개 변수

[in] hdc

디바이스 컨텍스트에 대한 핸들입니다. 함수는 이 디바이스 컨텍스트에 선택된 글꼴에 대한 정보를 가져옵니다.

[out, optional] lpSig

글꼴 서명 정보를 수신하는 FONTSIGNATURE 데이터 구조에 대한 포인터입니다.

TrueType 글꼴이 현재 디바이스 컨텍스트로 선택된 경우 FONTSIGNATURE 구조체는 코드 페이지를 식별하는 정보와 글꼴이 문자 모양을 제공하는 유니코드 하위 정렬을 받습니다.

TrueType 이외의 글꼴이 현재 디바이스 컨텍스트로 선택된 경우 FONTSIGNATURE 구조체는 0을 받습니다. 이 경우 애플리케이션은 TranslateCharsetInfo 함수를 사용하여 문자 집합에 대한 일반 글꼴 서명 정보를 가져와야 합니다.

lpSig 매개 변수는 애플리케이션에 FONTSIGNATURE 정보가 필요하지 않은 경우 NULL을 지정합니다. 이 경우 애플리케이션은 GetTextCharset 함수를 호출할 수도 있습니다. 이 함수는 lpSig가 NULL로 설정된 GetTextCharsetInfo를 호출하는 것과 같습니다.

[in] dwFlags

예약; 은 0으로 설정해야 합니다.

반환 값

성공하면 지정된 디바이스 컨텍스트에 현재 선택된 글꼴의 문자 집합을 식별하는 값을 반환합니다. 다음 문자 집합 식별자가 정의됩니다.

함수가 실패하면 반환 값이 DEFAULT_CHARSET.

요구 사항

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

추가 정보

FONTSIGNATURE

GetTextCharset

TranslateCharsetInfo

유니코드 및 문자 집합 함수

유니코드 및 문자 집합