GetClipboardData 함수(winuser.h)

아티클
08/27/2023

클립보드에서 지정된 형식으로 데이터를 검색합니다. 클립보드가 이전에 열렸어야 합니다.

구문

HANDLE GetClipboardData(
  [in] UINT uFormat
);

매개 변수

[in] uFormat

형식: UINT

클립보드 형식입니다. 표준 클립보드 형식에 대한 설명은 표준 클립보드 형식을 참조하세요.

반환 값

형식: HANDLE

함수가 성공하면 반환 값은 지정된 형식의 클립보드 개체에 대한 핸들입니다.

함수가 실패하면 반환 값은 NULL입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

주의 클립보드 데이터를 신뢰할 수 없습니다. 애플리케이션에서 사용하기 전에 데이터를 신중하게 구문 분석합니다.

애플리케이션은 EnumClipboardFormats 함수를 사용하여 사용 가능한 형식을 미리 열거할 수 있습니다.

클립보드는 애플리케이션이 아닌 GetClipboardData 함수가 반환하는 핸들을 제어합니다. 애플리케이션은 데이터를 즉시 복사해야 합니다. 애플리케이션은 핸들을 해제하거나 잠그지 않아야 합니다. EmptyClipboard 또는 CloseClipboard 함수가 호출된 후 또는 SetClipboardData 함수가 동일한 클립보드 형식으로 호출된 후에는 애플리케이션에서 핸들을 사용하지 않아야 합니다.

시스템은 애플리케이션이 GetClipboardData 함수를 호출할 때 특정 클립보드 형식 간에 암시적 데이터 형식 변환을 수행합니다. 예를 들어 CF_OEMTEXT 형식이 클립보드에 있는 경우 창은 CF_TEXT 형식으로 데이터를 검색할 수 있습니다. 클립보드의 형식은 요청된 요청된 형식으로 변환됩니다. 자세한 내용은 합성 클립보드 형식을 참조하세요.

예제

예제는 클립보드에 정보 복사를 참조하세요.

요구 사항


지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	winuser.h(Windows.h 포함)
라이브러리	User32.lib
DLL	User32.dll
API 세트	ext-ms-win-ntuser-misc-l1-2-0(Windows 8.1 도입)