ResUtilGetSzValue-Funktion (resapi.h)
Gibt einen Zeichenfolgenwert aus der Clusterdatenbank zurück.
Syntax
LPWSTR ResUtilGetSzValue(
[in] HKEY hkeyClusterKey,
[in] LPCWSTR pszValueName
);
Parameter
[in] hkeyClusterKey
Schlüssel, der den Speicherort des Werts in der Clusterdatenbank identifiziert.
[in] pszValueName
Eine mit NULL endende Unicode-Zeichenfolge, die den Namen des abzurufenden Werts enthält.
Rückgabewert
Wenn der Vorgang erfolgreich ist, gibt die Funktion einen Zeiger auf einen Puffer zurück, der den Zeichenfolgenwert enthält.
Wenn der Vorgang fehlschlägt, gibt die Funktion NULL zurück. Weitere Informationen erhalten Sie, wenn Sie die Funktion GetLastError aufrufen.
Hinweise
Die ResUtilGetSzValue-Hilfsprogrammfunktion weist den erforderlichen Arbeitsspeicher für den Zeichenfolgenparameterwert zu, bevor die Cluster-API-FunktionClusterRegQueryValue für den Zugriff auf die Clusterdatenbank aufgerufen wird. Wenn Sie mit diesem Speicher fertig sind, müssen Sie die Funktion LocalFree aufrufen, um sie freizugeben.
ResUtilGetSzValue unterstützt auch erweiterbare und mehrere Zeichenfolgenformate.
Anforderungen
| Anforderung | Wert |
|---|---|
| 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 |