EnumClipboardFormats 함수(winuser.h)

아티클
08/27/2023

클립보드에서 현재 사용할 수 있는 데이터 형식을 열거합니다.

클립보드 데이터 형식은 정렬된 목록에 저장됩니다. 클립보드 데이터 형식의 열거를 수행하려면 EnumClipboardFormats 함수를 일련의 호출합니다. 각 호출에 대해 format 매개 변수는 사용 가능한 클립보드 형식을 지정하고 함수는 사용 가능한 다음 클립보드 형식을 반환합니다.

구문

UINT EnumClipboardFormats(
  [in] UINT format
);

매개 변수

[in] format

형식: UINT

사용할 수 있는 것으로 알려진 클립보드 형식입니다.

클립보드 형식의 열거를 시작하려면 형식 을 0으로 설정합니다. format이 0이면 함수는 사용 가능한 첫 번째 클립보드 형식을 검색합니다. 열거 중 후속 호출의 경우 이전 EnumClipboardFormats 호출의 결과로 형식을 설정합니다.

반환 값

형식: UINT

함수가 성공하면 반환 값은 지정된 형식, 즉 사용 가능한 다음 클립보드 형식을 따르는 클립보드 형식입니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다. 클립보드가 열려 있지 않으면 함수가 실패합니다.

열거할 클립보드 형식이 더 이상 없으면 반환 값은 0입니다. 이 경우 GetLastError 함수는 ERROR_SUCCESS 값을 반환합니다. 이렇게 하면 함수 실패와 열거형 종료를 구분할 수 있습니다.

설명

해당 형식을 열거하기 전에 클립보드를 열어야 합니다. OpenClipboard 함수를 사용하여 클립보드를 엽니다. 클립보드가 열려 있지 않으면 EnumClipboardFormats 함수가 실패합니다.

EnumClipboardFormats 함수는 클립보드에 배치된 순서대로 형식을 열거합니다. 정보를 클립보드에 복사하는 경우 설명이 가장 적은 클립보드 형식에서 가장 설명이 적은 클립보드 형식으로 클립보드 개체를 순서대로 추가합니다. 클립보드에서 정보를 붙여넣는 경우 처리할 수 있는 첫 번째 클립보드 형식을 검색합니다. 이는 처리할 수 있는 가장 설명이 많은 클립보드 형식입니다.

시스템은 특정 클립보드 형식에 대한 자동 형식 변환을 제공합니다. 이러한 형식의 경우 이 함수는 지정된 형식을 열거한 다음 변환할 수 있는 형식을 열거합니다. 자세한 내용은 표준 클립보드 형식 및 합성된 클립보드 형식을 참조하세요.

예제

예제는 클립보드 뷰어의 예를 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	winuser.h(Windows.h 포함)
라이브러리	User32.lib
DLL	User32.dll
API 세트	ext-ms-win-ntuser-misc-l1-5-1(Windows 10 버전 10.0.14393에 도입됨)