ResUtilFindSzProperty-Funktion (resapi.h)
Sucht eine Zeichenfolgeneigenschaft in einer Eigenschaftenliste. Der PRESUTIL_FIND_SZ_PROPERTY Typ definiert einen Zeiger auf diese Funktion.
Syntax
DWORD ResUtilFindSzProperty(
[in] const PVOID pPropertyList,
[in] DWORD cbPropertyListSize,
[in] LPCWSTR pszPropertyName,
[out, optional] LPWSTR *pszPropertyValue
);
Parameter
[in] pPropertyList
Zeiger auf die Eigenschaftenliste, in der der Wert gesucht werden soll.
[in] cbPropertyListSize
Größe der in pPropertyList enthaltenen Daten in Byte.
[in] pszPropertyName
Zeiger auf eine mit NULL endende Unicode-Zeichenfolge, die den Namen des zu suchenden Werts enthält.
[out, optional] pszPropertyValue
Zeiger auf einen WCHAR-Zeiger auf einen Puffer (zugeordnet durch die Funktion), der eine Kopie des Eigenschaftswerts enthält. Sie müssen LocalFree (auf *pszPropertyValue) aufrufen, um den zugeordneten Arbeitsspeicher freizugeben. Wenn kein Wert erforderlich ist, übergeben Sie NULL für diesen Parameter.
Rückgabewert
Wenn die Vorgänge erfolgreich sind, gibt die Funktion ERROR_SUCCESS zurück.
Wenn der Vorgang fehlschlägt, gibt die Funktion einen Systemfehlercode zurück. Im Folgenden finden Sie mögliche Fehlercodes.
| Rückgabecode | Beschreibung |
|---|---|
|
Die Eigenschaftenliste ist falsch formatiert. |
|
Die Funktion konnte keinen Puffer zuordnen, in dem der Eigenschaftswert zurückgegeben werden soll. |
|
Die angegebene Eigenschaft konnte nicht in der Eigenschaftenliste gefunden werden. |
Hinweise
Wenn ResUtilFindSzProperty erfolgreich ist, verweist *pszPropertyValue auf eine Kopie der in pPropertyList gespeicherten Daten. Achten Sie darauf , LocalFree für *pszPropertyValue aufzurufen, um Speicherverluste zu verhindern.
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 |