DisassociateColorProfileFromDeviceA 함수(icm.h)
지정된 컴퓨터에서 지정된 디바이스와 지정된 색 프로필을 연결 해제합니다.
참고
이 API는 HDR 모니터에 대한 "고급 색" 프로필을 지원하지 않습니다. 고급 색 프로필을 관리하기 위해 ColorProfileRemoveDisplayAssociation 을 사용합니다.
구문
BOOL DisassociateColorProfileFromDeviceA(
PCSTR pMachineName,
PCSTR pProfileName,
PCSTR pDeviceName
);
매개 변수
pMachineName
예약되어 있습니다. NULL이어야 합니다. 이 매개 변수는 지정된 프로필과 디바이스를 연결 해제할 컴퓨터의 이름을 가리키기 위한 것입니다. NULL 포인터는 로컬 컴퓨터를 나타냅니다.
pProfileName
연결 해제할 프로필의 파일 이름에 대한 포인터입니다.
pDeviceName
연결 해제할 디바이스의 이름에 대한 포인터입니다.
반환 값
이 함수가 성공하면 반환 값은 TRUE입니다.
이 함수가 실패하면 반환 값은 FALSE입니다. 확장된 오류 정보는 GetLastError를 호출합니다.
설명
둘 이상의 프로필이 디바이스와 연결된 경우 WCS는 기본값으로 연결된 마지막 프로필을 사용합니다. 즉, 애플리케이션이 세 개의 프로필을 디바이스와 순차적으로 연결하는 경우 WCS는 마지막으로 연결된 프로필을 기본값으로 사용합니다. 그런 다음 애플리케이션이 DisassociateColorProfileFromDevice 함수를 호출하여 세 번째 프로필(이 예제의 기본값)을 연결 해제하는 경우 WCS는 두 번째 프로필을 기본값으로 사용합니다.
애플리케이션이 디바이스에서 모든 프로필을 연결 해제하는 경우 WCS는 sRGB 프로필을 기본값으로 사용합니다.
DisassociateColorProfileFromDevice 는 항상 지정된 디바이스에 대한 현재 사용자의 사용자별 프로필 연결 목록에서 지정된 프로필을 제거합니다. 목록에서 프로필을 제거하기 전에 DisassociateColorProfileFromDevice 는 사용자가 이전에 디바이스에 사용자별 프로필 연결 목록을 사용하려는 의사를 표시했는지 여부를 결정합니다. 그렇다면 DisassociateColorProfileFromDevice 는 디바이스에 대한 기존 사용자별 프로필 연결 목록에서 지정된 프로필을 제거합니다. 그렇지 않은 경우 DisassociateColorProfileFromDevice 는 해당 디바이스에 대한 시스템 전체 연결 목록을 복사하여 디바이스에 대한 새 사용자별 프로필 연결 목록을 만듭니다. 그런 다음 사용자별 목록에서 지정된 프로필을 제거합니다. 이 시점부터 현재 사용자는 usePerUserProfiles 매개 변수가 TRUE로 설정된 pDevice에 대해 WcsSetUsePerUserProfiles가 호출된 것처럼 지정된 디바이스에 대해 사용자별 프로필 연결 목록을 사용합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 머리글 | icm.h |
| 라이브러리 | Mscms.lib |
| DLL | Mscms.dll |