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 |
|---|---|
|
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 |