GetColorDirectoryW 함수(icm.h)

참고

이 API는 이후 릴리스에서 사용할 수 없습니다. 색 프로필 상호 작용에 다른 API를 사용하는 것이 좋습니다. 몇 가지 예제는 아래 표를 참조하세요.

시나리오	메커니즘
설치된 모든 프로필 열거	WcsEnumColorProfilesSize 및 WcsEnumColorProfiles 또는 EnumColorProfilesW 사용
색 프로필 설치/제거	InstallColorProfileW/UninstallColorProfileW 사용
직접 색 프로필 파일 열기	PROFILE 구조체 매개 변수에서 dwType=PROFILE_FILENAME OpenColorProfileW 를 사용합니다. 또는 WcsOpenColorProfileW를 사용합니다. Icm.h 에는 색 프로필 조작을 위해 반환된 HPROFILE을 허용하는 많은 API가 포함되어 있습니다.

지정된 컴퓨터에서 Windows COLOR 디렉터리의 경로를 검색합니다.

구문

BOOL GetColorDirectoryW(
  PCWSTR pMachineName,
  PWSTR  pBuffer,
  PDWORD pdwSize
);

pMachineName

예약; 은 NULL이어야 합니다. 이 매개 변수는 프로필을 설치할 컴퓨터의 이름을 가리키기 위한 것입니다. NULL 포인터는 로컬 컴퓨터를 나타냅니다.

pBuffer

색 디렉터리 경로를 배치할 버퍼를 가리킵니다.

pdwSize

pBuffer가 가리키는 버퍼의 크기(바이트)를 포함하는 변수를 가리킵니다. 반환 시 변수에는 실제로 사용되거나 필요한 버퍼의 크기가 포함됩니다.

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

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

사용자별/LUA 지원

색 디렉터리가 여전히 시스템 전체입니다. 이 함수는 LUA 컨텍스트에서 실행 가능합니다.

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
머리글	icm.h
라이브러리	Mscms.lib
DLL	Mscms.dll