ResUtilSetSzValue-Funktion (resapi.h)
Legt einen Zeichenfolgenwert in der Clusterdatenbank fest. Der PRESUTIL_SET_SZ_VALUE Typ definiert einen Zeiger auf diese Funktion.
Syntax
DWORD ResUtilSetSzValue(
[in] HKEY hkeyClusterKey,
[in] LPCWSTR pszValueName,
[in] LPCWSTR pszNewValue,
[in, out, optional] LPWSTR *ppszOutString
);
Parameter
[in] hkeyClusterKey
Schlüssel, der den Speicherort des Zeichenfolgenwerts in der Clusterdatenbank angibt.
[in] pszValueName
Unicode-Zeichenfolge mit Null-Endung, die den Namen des zu aktualisierenden Werts enthält.
[in] pszNewValue
Zeiger auf den neuen Zeichenfolgenwert.
[in, out, optional] ppszOutString
Zeiger auf einen Zeichenfolgenzeiger, der eine Kopie des aktualisierten Werts empfängt. Bei Verwendung müssen Aufrufer LocalFree auf *ppszOutValue aufrufen.
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 |
|---|---|
|
Beim Zuweisen von Arbeitsspeicher ist ein Fehler aufgetreten. |
Hinweise
Die ResUtilSetSzValue-Hilfsprogrammfunktion weist Arbeitsspeicher für den neuen Wert zu und ruft die Cluster-API-FunktionClusterRegSetValue auf. Bei Bedarf wird ein vorheriger Wert zugeordnet. Der neue Wert wird in den Inhalt von ppszOutValue kopiert.
Rufen Sie LocalFree auf *ppszOutValue auf, um Speicherverluste zu vermeiden.
Rufen Sie ResUtilSetSzValue nicht über die folgenden Ressourcen-DLL-Einstiegspunktfunktionen auf:
ResUtilSetSzValue kann von jeder anderen Ressourcen-DLL-Einstiegspunktfunktion oder aus einem Workerthread sicher aufgerufen werden. Weitere Informationen finden Sie unter Zu vermeidende Funktionsaufrufe in Ressourcen-DLLs.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 |