SetColorProfileElement 함수(icm.h)

ICC 색 프로필에서 태그가 지정된 프로필 요소의 요소 데이터를 설정합니다.

구문

BOOL SetColorProfileElement(
  HPROFILE hProfile,
  TAGTYPE  tag,
  DWORD    dwOffset,
  PDWORD   pcbElement,
  PVOID    pElement
);

hProfile

해당 ICC 프로필에 대한 핸들을 지정합니다.

tag

태그가 지정된 요소를 식별합니다.

dwOffset

쓰기를 시작할 태그가 지정된 요소 데이터의 첫 번째 바이트에서 오프셋을 지정합니다.

pcbElement

쓸 데이터 바이트 수를 포함하는 변수에 대한 포인터입니다. 반환될 때 실제로 작성된 바이트 수가 포함됩니다.

pElement

색 프로필의 태그가 지정된 요소에 쓸 데이터를 포함하는 버퍼에 대한 포인터입니다.

이 함수가 성공하면 반환 값은 TRUE입니다.

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

hProfile이 유효한 ICC 프로필이 아니면 이 함수가 실패합니다.

읽기/쓰기 권한에 대해 색 프로필을 열지 않으면 이 함수가 실패합니다.

dwOffset이 지정된 태그가 지정된 요소의 크기 집합을 초과하면 이 함수가 실패합니다.

dwOffset + *pcbSize가 지정된 요소의 크기보다 큰 경우 이 함수는 요소의 현재 크기에 맞는 만큼의 바이트만 씁니다.

이 함수가 성공하면 태그가 지정된 요소의 지정된 부분에 있는 기존 데이터를 덮어씁니다.

이 함수는 WCS(Windows Color System) 프로필 CAMP, DMP 및 GMMP를 지원하지 않습니다. 프로필 요소는 ICC 태그 형식과 암시적으로 연결되고 하드 코딩되며 강력한 XML 구문 분석 라이브러리가 많이 있기 때문입니다.

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
머리글	icm.h
라이브러리	Mscms.lib
DLL	Mscms.dll