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가 반환되고, 메서드가 실패하면 적절한 오류 코드를 반환합니다. 다음 표에서는 가능한 반환 상태 코드 중 일부를 보여 줍니다.
오류 코드 | Description |
---|---|
E_INVALIDARG | 매개 변수 bstrDeviceId 또는 phIcon이 NULL이거나 bstrDeviceId가 유효한 WIA 디바이스 ID 문자열을 가리키지 않음 |
E_FAIL | 사용할 수 있는 아이콘 리소스가 없습니다. |
E_NOTIMPL | 요청된 크기의 아이콘을 사용할 수 없습니다. |
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 |
WINDOWS XP [데스크톱 앱만 해당] |
지원되는 최소 서버 |
Windows Server 2003 [데스크톱 앱만 해당] |
헤더 |
|