AssociateColorProfileWithDeviceA 함수(icm.h)
지정된 색 프로필을 지정된 디바이스와 연결합니다.
참고
이 API는 HDR 모니터에 대한 "고급 색" 프로필을 지원하지 않습니다. 고급 색 프로필을 관리하기 위해 ColorProfileAddDisplayAssociation 을 사용합니다.
구문
BOOL AssociateColorProfileWithDeviceA(
PCSTR pMachineName,
PCSTR pProfileName,
PCSTR pDeviceName
);
매개 변수
pMachineName
예약되어 있습니다. NULL이어야 합니다. 이 매개 변수는 지정된 프로필과 디바이스를 연결할 컴퓨터의 이름을 가리키기 위한 것입니다. NULL 포인터는 로컬 컴퓨터를 나타냅니다.
pProfileName
연결할 프로필의 파일 이름을 가리킵니다.
pDeviceName
연결할 디바이스의 이름을 가리킵니다.
반환 값
이 함수가 성공하면 반환 값은 TRUE입니다.
이 함수가 실패하면 반환 값은 FALSE입니다. 확장 오류 정보는 GetLastError를 호출합니다.
설명
InstallColorProfileW 함수를 사용하여 프로필이 컴퓨터에 설치되지 않은 경우 AssociateColorProfileWithDevice 함수가 실패합니다.
Windows(Windows 95 이상)에서 프린터용 PostScript 디바이스 드라이버는 CMYK 색 모델을 가정합니다. 따라서 모든 PostScript 프린터는 CMYK 색 프로필을 사용해야 합니다. Windows 2000에는 이 제한이 없습니다.
지정된 디바이스가 모니터인 경우 이 함수는 기본 프로필을 업데이트합니다.
여러 프로필은 일반적으로 용지 및 잉크 유형에 따라 프린터와 연결됩니다. 기본값은 없습니다. GDI는 애플리케이션이 DC(디바이스 컨텍스트)를 만들 때 연결된 프로필에서 가장 적합한 항목을 선택합니다.
스캐너에는 기본 프로필도 없습니다. 그러나 둘 이상의 프로필을 스캐너와 연결하는 것은 비정형입니다.
AssociateColorProfileWithDevice는 항상 지정된 디바이스에 대한 현재 사용자의 사용자별 프로필 연결 목록에 지정된 프로필을 추가합니다. 목록에 프로필을 추가하기 전에 AssociateColorProfileWithDevice 는 사용자가 이전에 디바이스에 대해 사용자별 프로필 연결 목록을 사용하려는 의사를 표명했는지 여부를 결정합니다. 그렇다면 AssociateColorProfileWithDevice 는 지정된 프로필을 디바이스의 기존 사용자별 프로필 연결 목록에 추가하기만 하면 됩니다. 그렇지 않은 경우 AssociateColorProfileWithDevice 는 해당 디바이스에 대한 시스템 전체 연결 목록을 복사하여 디바이스에 대한 새 사용자별 프로필 연결 목록을 만듭니다. 그런 다음 지정된 프로필을 사용자별 목록에 추가합니다. 이 시점부터 현재 사용자는 usePerUserProfiles 매개 변수가 TRUE로 설정된 pDevice에 대해 WcsSetUsePerUserProfiles가 호출된 것처럼 지정된 디바이스에 대해 사용자별 프로필 연결 목록을 사용합니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows 10 빌드 20348 |
| 지원되는 최소 서버 | Windows 10 빌드 20348 |
| 머리글 | icm.h |