Share via


GetPriorityClipboardFormat 함수(winuser.h)

지정된 목록에서 사용 가능한 첫 번째 클립보드 형식을 검색합니다.

구문

int GetPriorityClipboardFormat(
  [in] UINT *paFormatPriorityList,
  [in] int  cFormats
);

매개 변수

[in] paFormatPriorityList

형식: UINT*

클립보드 형식을 우선 순위순으로 지정합니다. 표준 클립보드 형식에 대한 설명은 표준 클립보드 형식 을 참조하세요 .

[in] cFormats

형식: int

paFormatPriorityList 배열의 항목 수입니다. 이 값은 목록의 항목 수보다 크면 안 됩니다.

반환 값

형식: int

함수가 성공하면 반환 값은 데이터를 사용할 수 있는 목록의 첫 번째 클립보드 형식입니다. 클립보드가 비어 있으면 반환 값은 NULL입니다. 클립보드에 데이터가 포함되어 있지만 지정된 형식이 아닌 경우 반환 값은 –1입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

요구 사항

   
지원되는 최소 클라이언트 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에 도입됨)

추가 정보

클립보드

개념

CountClipboardFormats

EnumClipboardFormats

GetClipboardFormatName

IsClipboardFormatAvailable

참조

RegisterClipboardFormat