IDsDisplaySpecifier::GetIcon 메서드(dsclient.h)

IDsDisplaySpecifier::GetIcon 메서드는 지정된 개체 클래스에 대한 아이콘을 가져옵니다.

구문

HICON GetIcon(
  [in] LPCWSTR pszObjectClass,
  [in] DWORD   dwFlags,
  [in] INT     cxIcon,
  [in] INT     cyIcon
);

[in] pszObjectClass

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

[in] dwFlags

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

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

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

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

DSGIF_ISNORMAL, DSGIF_ISOPEN및DSGIF_ISDISABLED 플래그를 마스킹하는 데 사용됩니다.

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

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

[in] cxIcon

아이콘의 원하는 너비(픽셀)를 포함합니다. 이 메서드는 이 너비와 가장 일치하는 아이콘을 가져옵니다.

[in] cyIcon

아이콘의 원하는 높이(픽셀)를 포함합니다. 이 메서드는 이 높이와 가장 일치하는 아이콘을 가져옵니다.

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