INamedPropertyStore::GetNamedValue-Methode (propsys.h)

Ruft den Wert einer benannten Eigenschaft aus dem benannten Eigenschaftenspeicher ab.

Syntax

HRESULT GetNamedValue(
  [in]  LPCWSTR     pszName,
  [out] PROPVARIANT *ppropvar
);

Parameter

[in] pszName

Typ: LPCWSTR

Ein Zeiger auf den Eigenschaftennamen als Unicode-Zeichenfolge der Eigenschaft im benannten Eigenschaftenspeicher.

[out] ppropvar

Typ: PROPVARIANT*

Wenn diese Methode zurückgibt, enthält einen Zeiger auf eine PROPVARIANT-Struktur , die den Wert der Eigenschaft enthält.

Rückgabewert

Typ: HRESULT

Gibt bei erfolgreicher Ausführung S_OK oder andernfalls einen Fehlerwert zurück.

Wenn die in pszName benannte Eigenschaft nicht im Eigenschaftenspeicher gefunden wird, gibt diese Methode S_OK zurück, und der pv-Member ist auf VT_EMPTY festgelegt.

Anforderungen