GetStandardColorSpaceProfileW 함수(icm.h)
지정된 표준 색 공간에 대해 등록된 색 프로필을 검색 합니다.
구문
BOOL GetStandardColorSpaceProfileW(
PCWSTR pMachineName,
DWORD dwSCS,
PWSTR pBuffer,
PDWORD pcbSize
);
매개 변수
pMachineName
예약되어 있습니다. NULL이어야 합니다. 이 매개 변수는 표준 색 공간 프로필을 가져올 컴퓨터의 이름을 가리키기 위한 것입니다. NULL 포인터는 로컬 컴퓨터를 나타냅니다.
dwSCS
프로필을 검색할 표준 색 공간의 ID 값을 지정합니다. 이 매개 변수에 유효한 값은 LCS_sRGB LCS_WINDOWS_COLOR_SPACE.
pBuffer
프로필 이름을 배치할 버퍼에 대한 포인터입니다. NULL이면 호출은 TRUE를 반환하고 버퍼의 필요한 크기는 pdwSize에 배치됩니다.
pcbSize
pProfileName이 가리키는 버퍼의 크기(바이트)를 포함하는 변수에 대한 포인터입니다. 반환 시 변수에는 실제로 사용되거나 필요한 버퍼의 크기가 포함됩니다.
반환 값
이 함수가 성공하면 반환 값은 TRUE입니다.
이 함수가 실패하면 반환 값은 FALSE입니다. 확장된 오류 정보는 GetLastError를 호출합니다.
설명
pProfileName이 가리키는 버퍼가 애플리케이션에서 동적으로 할당되는 경우 애플리케이션은 GetStandardColorSpaceProfile 함수를 호출하여 버퍼에 필요한 크기를 검색할 수 있습니다. PProfileName이 NULL로 설정된 GetStandardColorSpaceProfile이 호출되면 FALSE가 반환되고 pdwSize가 가리키는 DWORD에는 pProfileName이 가리키는 버퍼에 필요한 바이트 수가 포함됩니다. 그러면 애플리케이션이 버퍼를 할당하고 pProfileName이 버퍼의 주소로 설정된 상태에서 GetStandardColorSpaceProfile을 다시 호출할 수 있습니다.
이 함수는 ICC(International Color Consortium) 프로필 외에도 WCS(Windows Color System) DMP(디바이스 모델 프로필)를 지원합니다. WCS CAMP 또는 GMMP 프로필을 지원하지 않으며 이러한 프로필을 사용하는 경우 오류를 반환합니다.
Windows Vista 특정 기능 개요
이렇게 하면 ICC 프로필 외에도 WCS DMP가 지원됩니다. WCS CAMP 또는 GMMP 프로필을 지원하지 않으며 이러한 프로필이 이 API와 함께 사용되는 경우 오류를 반환합니다.
사용자별/LUA 지원
그러면 현재 사용자의 지정된 표준 색 공간에 대해 등록된 색 프로필이 검색됩니다. 현재 사용자에 대한 이러한 설정이 없으면 시스템 전체 설정을 검색합니다.
이렇게 하면 WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER WcsGetDefaultColorProfile 이 사용됩니다.
LUA 컨텍스트에서 실행 가능합니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 머리글 | icm.h |
| 라이브러리 | Mscms.lib |
| DLL | Mscms.dll |