ResUtilGetMultiSzValue-Funktion (resapi.h)
Gibt einen Wert mit mehreren Zeichenfolgen aus der Clusterdatenbank zurück.
Syntax
DWORD WINAPI_INLINE ResUtilGetMultiSzValue(
[in] HKEY hkeyClusterKey,
[in] LPCWSTR pszValueName,
[out, optional] LPWSTR *ppszOutValue,
[out] LPDWORD pcbOutValueSize
);
Parameter
[in] hkeyClusterKey
Schlüssel, der den Speicherort des Werts mit mehreren Zeichenfolgen in der Clusterdatenbank angibt.
[in] pszValueName
Zeiger auf eine mit NULL beendete Unicode-Zeichenfolge, die den Namen des abzurufenden Werts enthält.
[out, optional] ppszOutValue
Adresse des Zeigers auf den abgerufenen Wert.
[out] pcbOutValueSize
Zeiger auf ein DWORD , in dem die Größe des Puffers in Bytes zurückgegeben wird, auf den ppszOutValue verweist.
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 ist ein möglicher Fehlercode aufgeführt.
| Rückgabecode | Beschreibung |
|---|---|
|
Während der Speicherzuordnung ist ein Fehler aufgetreten. |
Hinweise
Wenn Sie mit dem Speicher fertig sind, der für den Wert zugewiesen ist, der von der ResUtilGetMultiSzValue-Hilfsprogrammfunktion zurückgegeben wird, müssen Sie die Funktion LocalFree aufrufen, um sie freizugeben.
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 |