ResUtilGetSzProperty-Funktion (resapi.h)

Ruft eine Zeichenfolgeneigenschaft aus einer Eigenschaftenliste ab und führt einen Zeiger auf die nächste Eigenschaft in der Liste aus. Der PRESUTIL_GET_SZ_PROPERTY Typ definiert einen Zeiger auf diese Funktion.

Syntax

DWORD ResUtilGetSzProperty(
  [out]          LPWSTR             *ppszOutValue,
  [in]           const PCLUSPROP_SZ pValueStruct,
  [in, optional] LPCWSTR            pszOldValue,
  [in, out]      LPBYTE             *ppPropertyList,
  [in, out]      LPDWORD            pcbPropertyListSize
);

Parameter

[out] ppszOutValue

Adresse eines Zeigers, in dem der Zeichenfolgenwert aus der Eigenschaftenliste zurückgegeben wird.

[in] pValueStruct

Zeiger auf eine CLUSPROP_SZ-Struktur , die den Zeichenfolgenwert angibt, der aus der Eigenschaftenliste abgerufen werden soll.

[in, optional] pszOldValue

Zeiger auf den vorherigen Wert der Eigenschaft.

[in, out] ppPropertyList

Adresse des Zeigers auf den Eigenschaftenlistenpuffer, der die Zeichenfolgeneigenschaft enthält. Dieser Zeiger wird bis zum Anfang der nächsten Eigenschaft erweitert.

[in, out] pcbPropertyListSize

Zeiger auf die Größe des Eigenschaftenlistenpuffers. Die Größe wird verringert, um den Fortschritt des ppPropertyList-Zeigers zu berücksichtigen.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Funktion ERROR_SUCCESS zurück.

Wenn der Vorgang fehlschlägt, gibt die Funktion einen Systemfehlercode zurück. Im Folgenden ist ein möglicher Fehlercode aufgeführt.

Rückgabecode	Beschreibung
ERROR_INVALID_PARAMETER	Die Daten sind falsch formatiert.

Anforderungen

Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Zielplattform	Windows
Kopfzeile	resapi.h
Bibliothek	ResUtils.lib
DLL	ResUtils.dll

Weitere Informationen

ResUtilGetBinaryProperty

ResUtilGetDwordProperty

ResUtilGetMultiSzProperty