DsGetIcon 함수(dsclient.h)

DsGetIcon 함수는 지정된 개체 클래스의 아이콘을 가져옵니다. 이 함수는 사용되지 않습니다. 새 애플리케이션은 IDsDisplaySpecifier::GetIcon 메서드를 사용하여 이 함수를 수행해야 합니다.

구문

HICON DsGetIcon(
  [in] DWORD   dwFlags,
  [in] LPCWSTR pszObjectClass,
  [in] INT     cxImage,
  [in] INT     cyImage
);

매개 변수

[in] dwFlags

검색할 아이콘의 유형을 나타내는 플래그 집합을 포함합니다. 다음 값 중 하나 이상의 조합일 수 있습니다.

DSGIF_ISNORMAL

개체 클래스의 일반 아이콘을 가져옵니다.

DSGIF_ISOPEN

개체 클래스에 대해 열린 폴더와 같은 열린 아이콘을 가져옵니다. 개체 클래스에 열려 있는 아이콘이 없는 경우 이 함수는 개체 클래스에 대한 일반 아이콘을 가져오려고 시도합니다.

DSGIF_ISDISABLED

개체 클래스에 대해 비활성화된 사용자와 같은 비활성화된 아이콘을 가져옵니다. 개체 클래스에 비활성화된 아이콘이 없는 경우 이 함수는 개체 클래스에 대한 일반 아이콘을 가져오려고 시도합니다.

DSGIF_GETDEFAULTICON

개체 클래스에 대한 아이콘을 찾을 수 없는 경우 이 함수는 기본 아이콘을 반환합니다. 이 플래그를 지정하지 않고 개체 클래스에 대한 아이콘을 찾을 수 없는 경우 이 함수는 NULL을 반환합니다.

DSGIF_DEFAULTISCONTAINER

개체 클래스에 대한 아이콘을 찾을 수 없는 경우 이 함수는 컨테이너 아이콘을 기본 아이콘으로 반환합니다. 이 플래그를 지정하지 않고 개체 클래스에 대한 아이콘을 찾을 수 없는 경우 이 함수는 NULL을 반환합니다.

[in] pszObjectClass

아이콘을 검색할 개체 클래스의 이름을 포함하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다. 개체 클래스 이름의 예로는 "user" 및 "container"가 있습니다.

[in] cxImage

아이콘의 원하는 너비(픽셀)를 포함합니다. 이 함수는 이 너비와 가장 일치하는 아이콘을 검색합니다.

[in] cyImage

아이콘의 원하는 높이(픽셀)를 포함합니다. 이 함수는 이 높이와 가장 일치하는 아이콘을 검색합니다.

반환 값

성공하면 아이콘에 대한 핸들을 반환하고, 그렇지 않으면 NULL 을 반환합니다. 호출자는 이 핸들을 DestroyIcon에 전달하여 더 이상 필요하지 않은 경우 이 아이콘을 삭제해야 합니다.

요구 사항

추가 정보

DestroyIcon

IDsDisplaySpecifier::GetIcon