EnumColorProfilesW 함수(icm.h)
지정된 열거형 조건을 충족하는 모든 프로필을 열거합니다.
구문
BOOL EnumColorProfilesW(
PCWSTR pMachineName,
PENUMTYPEW pEnumRecord,
PBYTE pEnumerationBuffer,
PDWORD pdwSizeOfEnumerationBuffer,
PDWORD pnProfiles
);
매개 변수
pMachineName
예약되어 있습니다. NULL이어야 합니다. 이 매개 변수는 프로필을 열거할 컴퓨터의 이름을 가리키기 위한 것입니다. NULL 포인터는 로컬 컴퓨터를 나타냅니다.
pEnumRecord
열거형 조건을 지정하는 구조체에 대한 포인터입니다.
pEnumerationBuffer
프로필을 열거할 버퍼에 대한 포인터입니다. *pEnumRecord에 지정된 조건을 충족하는 프로필 이름의 MULTI_SZ 문자열이 이 버퍼에 배치됩니다.
pdwSizeOfEnumerationBuffer
pBuffer가 가리키는 버퍼의 크기를 포함하는 변수에 대한 포인터입니다. 반환할 때 *pdwSize 에는 실제로 사용되거나 필요한 버퍼의 크기가 포함됩니다.
pnProfiles
반환 시 실제로 버퍼에 복사된 프로필 이름 수를 포함할 변수에 대한 포인터입니다.
반환 값
이 함수가 성공하면 반환 값은 TRUE입니다.
이 함수가 실패하면 반환 값은 FALSE입니다. 확장된 오류 정보는 GetLastError를 호출합니다.
설명
여러 프로필은 일반적으로 용지 및 잉크 유형에 따라 프린터와 연결됩니다. 각 디바이스에 대한 기본 프로필이 있습니다. ICC(International Color Consortium) 프로필의 경우 GDI는 애플리케이션이 DC(디바이스 컨텍스트)를 만들 때 ICC 관련 프로필에서 가장 적합한 프로필을 선택합니다.
EnumColorProfiles를 사용하여 디바이스의 기본 프로필을 결정하지 마세요. 대신 디바이스에 대한 디바이스 컨텍스트를 만든 다음 GetICMProfile 함수를 호출합니다. Windows Vista 및 Windows 7에서는 WcsGetDefaultColorProfile 함수를 사용하여 디바이스의 기본 색 프로필을 확인할 수도 있습니다.
pEnumRecord 매개 변수가 가리키는 ENUMTYPE 형식 구조의 dwFields 멤버가 ET_DEVICENAME 설정된 경우 이 함수는 디바이스 클래스에 관계없이 사용자의 컴퓨터에 연결된 모든 유형의 디바이스와 연결된 모든 색 프로필을 열거합니다. pEnumRecord 매개 변수가 가리키는 구조체의 dwFields 멤버가 ET_DEVICENAME 또는 ET_DEVICECLASS 설정되고 디바이스 클래스가 구조체의 dwDeviceClass 멤버에 지정된 경우 이 함수는 지정된 디바이스 클래스와 연결된 프로필만 열거합니다. dwFields 멤버가 ET_DEVICECLASS만 설정된 경우 EnumColorProfiles 함수는 해당 유형의 디바이스와 연결할 수 있는 모든 프로필을 열거합니다.
EnumColorProfiles가 특정 디바이스와 연결된 프로필을 검사할 때마다 결과는 사용자가 해당 디바이스와 연결된 시스템 차원의 프로필 목록을 사용하도록 선택했는지 또는 자신의 자체("사용자별") 목록을 사용하도록 선택했는지에 따라 달라집니다. usePerUserProfiles 매개 변수를 TRUE로 설정하여 WcsSetUsePerUserProfiles를 호출하면 이후 EnumColorProfiles를 호출하여 지정된 디바이스에 대한 현재 사용자의 사용자별 프로필 연결 목록만 확인합니다. usePerUserProfiles 매개 변수를 FALSE로 설정하여 WcsSetUsePerUserProfiles를 호출하면 이후 EnumColorProfiles를 호출하여 지정된 디바이스에 대한 시스템 차원의 프로필 연결 목록을 확인합니다. WcsSetUsePerUserProfiles가 현재 사용자에 대해 호출된 적이 없는 경우 EnumColorProfiles는 시스템 전체 목록을 검사합니다.
애플리케이션 은 EnumColorProfiles 를 사용하여 프로필이 열거되는 버퍼의 크기를 가져올 수 있습니다. pBuffer 매개 변수가 NULL로 설정된 EnumColorProfiles 함수를 호출해야 합니다. 함수가 반환되면 pdwSize 매개 변수에 필요한 버퍼 크기(바이트)가 포함됩니다. 프로그램에서 해당 정보를 사용하여 열거형 버퍼를 할당할 수 있습니다. 그런 다음 pBuffer 매개 변수가 버퍼의 주소로 설정된 상태에서 EnumColorProfiles를 다시 호출할 수 있습니다.
이 함수는 일관된 프로필 열거를 사용하도록 설정에서 WCS 관련 DMP 정보를 레거시 EnumType 레코드로 변환하기 위한 정보를 제공합니다. 이 정보가 없는 경우 기본값은 ICC와 동일합니다.
사용자별/LUA 지원
열거형은 현재 사용자와 관련이 있습니다. 시스템 전체 및 현재 사용자 디바이스 연결이 모두 고려됩니다. 기본 프로필 구성의 경우 현재 사용자 설정은 시스템 전체 설정을 재정의합니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 머리글 | icm.h |