InternalGetWindowText 함수(winuser.h)

아티클
03/13/2024

[이 함수는 일반적인 용도로 사용되지 않습니다. 이후 버전의 Windows에서는 변경되거나 사용할 수 없습니다.]

지정된 창의 제목 표시줄 텍스트(있는 경우)를 버퍼에 복사합니다.

이 함수는 GetWindowText 함수와 비슷합니다. 그러나 지정된 창의 핸들과 연결된 창 구조에서 창 텍스트를 직접 가져온 다음 항상 텍스트를 유니코드 문자열로 제공합니다. 창에 WM_GETTEXT 메시지를 전송하여 텍스트를 가져오는 GetWindowText와는 다릅니다. 지정한 창이 컨트롤이면 컨트롤의 텍스트를 가져옵니다.

구문

int InternalGetWindowText(
  [in]  HWND   hWnd,
  [out] LPWSTR pString,
  [in]  int    cchMaxCount
);

매개 변수

[in] hWnd

형식: HWND

텍스트를 포함하는 창 또는 컨트롤에 대한 핸들입니다.

[out] pString

형식: LPWSTR

텍스트를 받을 버퍼입니다.

문자열이 버퍼보다 길거나 길면 문자열이 잘리고 null 문자로 종료됩니다.

[in] cchMaxCount

형식: int

null 문자를 포함하여 버퍼에 복사할 최대 문자 수입니다. 텍스트가 이 제한을 초과하면 잘립니다.

반환 값

형식: int

함수가 성공하면 반환 값은 종료 null 문자를 포함하지 않고 복사된 문자열의 길이(문자)입니다.

창에 제목 표시줄이나 텍스트가 없거나 제목 표시줄이 비어 있거나 창 또는 컨트롤 핸들이 유효하지 않은 경우 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

이 함수는 Windows XP SP1(서비스 팩 1) 및 Windows Server 2003까지 SDK 헤더 및 라이브러리에 포함되지 않았습니다. 이 함수에 대한 헤더 파일 및 가져오기 라이브러리가 없는 경우 LoadLibrary 및 GetProcAddress를 사용하여 함수를 호출할 수 있습니다.

요구 사항

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