IWiaUIExtension2::GetDeviceIcon-Methode

Ruft ein benutzerdefiniertes Gerätesymbol ab.

Syntax

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

Parameter

bstrDeviceId [in]

Typ: BSTR

Gibt die Geräte-ID des WIA-Geräts an, für das das Symbol abgerufen werden soll.

phIcon [out]

Typ: HICON*

Zeigt auf einen Speicherort im Arbeitsspeicher, der ein Handle für das Symbol für das Gerät erhält.

nSize [in]

Typ: ULONG

Gibt die gewünschte Symbolgröße in Pixel an. Das Symbol wird als quadratisch angenommen, und nSize gibt sowohl die Breite als auch die Höhe des angeforderten Symbols an.

Rückgabewert

Typ: HRESULT

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn die Methode fehlschlägt, wird ein entsprechender Fehlercode zurückgegeben. In der folgenden Tabelle sind einige der möglichen Rückgabecodes status aufgeführt.

Fehlercode	BESCHREIBUNG
E_INVALIDARG	Der Parameter bstrDeviceId oder phIcon ist NULL, oder bstrDeviceId verweist nicht auf eine gültige WIA-Geräte-ID-Zeichenfolge.
E_FAIL	Es ist keine Symbolressource verfügbar.
E_NOTIMPL	Es ist kein Symbol der angeforderten Größe verfügbar.

 

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Header	Wiadevd.h