SetStandardColorSpaceProfileA 함수(icm.h)

지정된 표준 색 공간에 대해 지정된 프로필을 등록합니다. GetStandardColorSpaceProfileW를 사용하여 프로필을 쿼리할 수 있습니다.

구문

BOOL SetStandardColorSpaceProfileA(
  PCSTR pMachineName,
  DWORD dwProfileID,
  PCSTR pProfilename
);

매개 변수

pMachineName

예약되어 있습니다. NULL이어야 합니다. 이 매개 변수는 표준 색 공간 프로필을 설정할 컴퓨터의 이름을 가리키기 위한 것입니다. NULL 포인터는 로컬 컴퓨터를 나타냅니다.

dwProfileID

지정된 프로필이 나타내는 표준 색 공간의 ID 값을 지정합니다. 애플리케이션 내에서 색 공간 프로필을 고유하게 식별하는 데 사용되는 사용자 지정 ID 값입니다.

pProfilename

프로필 파일의 정규화된 경로를 가리킵니다.

반환 값

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

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

설명

표준 색 공간에 등록하려면 먼저 프로필이 시스템에 이미 설치되어 있어야 합니다.

이 함수는 ICC(International Color Consortium) 프로필 외에도 WCS(Windows Color System) DMP(디바이스 모델 프로필)를 지원합니다. WCS CAMP 또는 GMMP 프로필을 지원하지 않으며 이러한 프로필을 사용하는 경우 오류를 반환합니다.

사용자별/LUA 지원

그러면 현재 사용자에 대해서만 지정된 표준 색 공간에 대해 지정된 프로필이 등록됩니다.

WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER WcsSetDefaultColorProfile 을 사용합니다.

프로필이 이미 설치된 경우 LUA 컨텍스트에서 실행 가능하며, 설치가 시스템 수준이며 관리자 권한이 필요하므로 액세스가 거부된 상태에서 실패합니다.

요구 사항

참고 항목

• 기본 색 관리 개념
• 함수
• SetStandardColorSpaceProfileW