IWiaUIExtension2::GetDeviceIcon 메서드

  • 아티클

사용자 지정 디바이스 아이콘을 가져옵니다.

구문

HRESULT GetDeviceIcon(
  [in]  BSTR  bstrDeviceId,
  [out] HICON *phIcon,
  [in]  ULONG nSize
);

매개 변수

bstrDeviceId [in]

형식: BSTR

아이콘을 가져올 WIA 디바이스의 디바이스 ID를 지정합니다.

phIcon [out]

형식: HICON*

디바이스 아이콘에 대한 핸들을 받을 메모리 위치를 가리킵니다.

nSize [in]

형식: ULONG

원하는 아이콘 크기를 픽셀 단위로 지정합니다. 아이콘은 정사각형으로 간주되며 nSize는 요청된 아이콘의 너비와 높이를 모두 지정합니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK가 반환되고, 메서드가 실패하면 적절한 오류 코드를 반환합니다. 다음 표에서는 가능한 반환 상태 코드 중 일부를 보여 줍니다.

오류 코드 설명
E_INVALIDARG bstrDeviceId 또는 phIcon 매개 변수가 NULL이거나 bstrDeviceId가 유효한 WIA 디바이스 ID 문자열을 가리키지 않음
E_FAIL 아이콘 리소스를 사용할 수 없습니다.
E_NOTIMPL 요청된 크기의 아이콘을 사용할 수 없습니다.

 

요구 사항

요구 사항 값
지원되는 최소 클라이언트
 Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버
 Windows Server 2003 [데스크톱 앱만 해당]
헤더
Wiadevd.h