IWiaPropertyStorage::GetPropertyStream-Methode (wia_xp.h)
Die IWiaPropertyStorage::GetPropertyStream-Methode ruft den Eigenschaftenstream eines Elements ab.
Syntax
HRESULT GetPropertyStream(
[out] GUID *pCompatibilityId,
[out] IStream **ppIStream
);
Parameter
[out] pCompatibilityId
Typ: GUID*
Empfängt einen eindeutigen Bezeichner für einen Satz von Eigenschaftenwerten.
[out] ppIStream
Typ: IStream**
Zeiger auf einen Stream, der die Elementeigenschaften empfängt. Weitere Informationen finden Sie unter IStream.
Rückgabewert
Typ: HRESULT
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Anwendungen verwenden diese Methode, um eine Momentaufnahme der aktuellen Eigenschaften eines Elements abzurufen. Diese werden anschließend durch Aufrufen von IWiaPropertyStorage::SetPropertyStream wiederhergestellt.
Anwendungen können den pCompatibilityID-Parameter verwenden, um zu überprüfen, ob ein Gerät einen bestimmten Satz von Eigenschaftenwerten unterstützt, bevor sie versuchen, diese Werte auf das Gerät zu schreiben.
Wenn die Verwendung des Eigenschaftenstreams des Elements abgeschlossen ist, muss es von der Anwendung freigegeben werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional, Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | wia_xp.h (einschließlich Wia.h) |
| Bibliothek | Wiaguid.lib |
| DLL | Wiaservc.dll |