Freigeben über


PropVariantToWinRTPropertyValue-Funktion (propsys.h)

Extrahiert Daten aus einer PROPVARIANT-Struktur in einen Windows-Runtime-Eigenschaftswert. Beachten Sie, dass in einigen Fällen mehr als ein PROPVARIANT-Typ einem einzelnen Windows-Runtime Eigenschaftentyp zugeordnet ist.

Syntax

PSSTDAPI PropVariantToWinRTPropertyValue(
  [in]  REFPROPVARIANT propvar,
  [in]  REFIID         riid,
  [out] void           **ppv
);

Parameter

[in] propvar

Verweis auf eine PROPVARIANT-Quellstruktur .

[in] riid

Ein Verweis auf die IID der Schnittstelle, die über ppv abgerufen werden soll, in der Regel IID_IPropertyValue (definiert in Windows.Foundation.h).

[out] ppv

Wenn diese Methode erfolgreich zurückgibt, enthält den in riid angeforderten Schnittstellenzeiger. Dies ist in der Regel ein IPropertyValue-Zeiger . Wenn der Aufruf fehlschlägt, ist dieser Wert NULL.

Rückgabewert

Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Es wird empfohlen, das makro IID_PPV_ARGS zu verwenden, das in Objbase.h definiert ist, um die Parameter riid und ppv zu packen. Dieses Makro stellt die richtige IID basierend auf der Schnittstelle bereit, auf die der Wert in ppv verweist, wodurch die Möglichkeit eines Codierungsfehlers in riid beseitigt wird, der zu unerwarteten Ergebnissen führen kann.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile propsys.h (einschließlich Windows.Foundation.h)
Bibliothek Propsys.lib
DLL Propsys.dll

Weitere Informationen

PropertyValue-Klasse