Freigeben über


IScanProfile::GetProperty-Methode

Ruft den Wert der angegebenen untergeordneten Eigenschaften im <Properties> Element eines Scanprofils ab.

Syntax

HRESULT GetProperty(
  [in]  ULONG       num,
  [in]  PROPID      *pid,
  [out] PROPVARIANT *pvar
);

Parameter

num [in]

Typ: ULONG

Die Anzahl der Einträge in den Arrays, auf die von pid und pvar verwiesen wird.

pid [in]

Typ: PROPID*

Ein Zeiger auf ein Array der Identifikationsnummern der festzulegenden Eigenschaften. Jeder Wert im Array ist eine WIA-Eigenschaftskonstanten.

pvar [out]

Typ: PROPVARIANT*

Ein Zeiger auf ein Array von Werten.

Rückgabewert

Typ: HRESULT

Gibt S_FALSE zurück, wenn einer der Eigenschaftswerte nicht verfügbar ist. Gibt andernfalls S_OK oder einen COM-Standardfehlercode zurück.

Bemerkungen

Der Typ jedes Werts muss derselbe Typ sein, der mit dem Aufruf von IScanProfile::SetProperty festgelegt wurde.

Jeder Wert im Array, auf das pid verweist, ist eine der WIA-Eigenschaftskonstanten. Sie können dieses Identifikationssystem erweitern. Weitere Informationen finden Sie unter Definieren von benutzerdefinierten Eigenschaften.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Server 2008 [nur Desktop-Apps]
Header
Scanprofile.h
IDL
Scanprofiles.idl

Siehe auch

IScanProfile

Konzept

Scanprofilschema

WIA-Eigenschaftskonstanten

Definieren benutzerdefinierter Eigenschaften