GetClipboardData 함수(winuser.h)
클립보드에서 지정된 형식으로 데이터를 검색합니다. 클립보드가 이전에 열렸어야 합니다.
구문
HANDLE GetClipboardData(
[in] UINT uFormat
);
매개 변수
[in] uFormat
형식: UINT
클립보드 형식입니다. 표준 클립보드 형식에 대한 설명은 표준 클립보드 형식을 참조하세요.
반환 값
형식: HANDLE
함수가 성공하면 반환 값은 지정된 형식의 클립보드 개체에 대한 핸들입니다.
함수가 실패하면 반환 값은 NULL입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.
설명
주의 클립보드 데이터를 신뢰할 수 없습니다. 애플리케이션에서 사용하기 전에 데이터를 신중하게 구문 분석합니다.
클립보드는 애플리케이션이 아닌 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 도입) |
추가 정보
개념
참조