RegLoadMUIStringA-Funktion (winreg.h)
Lädt die angegebene Zeichenfolge aus dem angegebenen Schlüssel und Unterschlüssel.
Syntax
LSTATUS RegLoadMUIStringA(
[in] HKEY hKey,
[in, optional] LPCSTR pszValue,
[out, optional] LPSTR pszOutBuf,
[in] DWORD cbOutBuf,
[out, optional] LPDWORD pcbData,
[in] DWORD Flags,
[in, optional] LPCSTR pszDirectory
);
Parameter
[in] hKey
Ein Handle für einen geöffneten Registrierungsschlüssel. Der Schlüssel muss mit dem Zugriffsrecht KEY_QUERY_VALUE geöffnet worden sein. Weitere Informationen finden Sie unter Sicherheit und Zugriffsrechte für Registrierungsschlüssel.
Dieses Handle wird von der RegCreateKeyEx- oder RegOpenKeyEx-Funktion zurückgegeben. Es kann auch einer der folgenden vordefinierten Schlüssel sein:
- HKEY_CLASSES_ROOT
- HKEY_CURRENT_CONFIG
- HKEY_CURRENT_USER
- HKEY_LOCAL_MACHINE
- HKEY_USERS
[in, optional] pszValue
Der Name des Registrierungswerts.
[out, optional] pszOutBuf
Ein Zeiger auf einen Puffer, der die Zeichenfolge empfängt.
Zeichenfolgen der folgenden Form erhalten eine besondere Behandlung:
@[pfad]\dllname,-strID
Die Zeichenfolge mit dem Bezeichner strID wird aus dllname geladen. der Pfad ist optional. Wenn der pszDirectory-Parameter nicht NULL ist, wird das Verzeichnis dem pfad vorangestellt, der in den Registrierungsdaten angegeben ist. Beachten Sie, dass dllname Umgebungsvariablen enthalten kann, die erweitert werden sollen.
[in] cbOutBuf
Die Größe des pszOutBuf-Puffers in Bytes.
[out, optional] pcbData
Ein Zeiger auf eine Variable, die die Größe der in den pszOutBuf-Puffer kopierten Daten in Byte empfängt.
Wenn der Puffer nicht groß genug ist, um die Daten zu speichern, gibt die Funktion ERROR_MORE_DATA zurück und speichert die erforderliche Puffergröße in der Variablen, auf die von pcbData verwiesen wird. In diesem Fall ist der Inhalt des Puffers nicht definiert.
[in] Flags
Dieser Parameter kann 0 oder der folgende Wert sein.
[in, optional] pszDirectory
Der Verzeichnispfad.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.
Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Systemfehlercode.
Wenn der pcbData-Puffer zu klein ist, um die Zeichenfolge zu empfangen, gibt die Funktion ERROR_MORE_DATA zurück.
Die ANSI-Version dieser Funktion gibt ERROR_CALL_NOT_IMPLEMENTED zurück.
Hinweise
Die RegLoadMUIString-Funktion wird nur für Unicode unterstützt. Obwohl sowohl Unicode-Versionen (W) als auch ANSI(A) dieser Funktion deklariert sind, gibt die RegLoadMUIStringA-Funktion ERROR_CALL_NOT_IMPLEMENTED zurück. Anwendungen sollten RegLoadMUIStringW explizit aufrufen oder Unicode als Zeichensatz in PInvoke-Aufrufen (Platform Invoke) angeben.
Um eine Anwendung zu kompilieren, die diese Funktion verwendet, definieren Sie _WIN32_WINNT als 0x0600 oder höher. Weitere Informationen finden Sie unter Verwenden der Windows-Header.
Hinweis
Der winreg.h-Header definiert RegLoadMUIString als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | winreg.h (Windows.h einschließen) |
Bibliothek | Advapi32.lib |
DLL | Advapi32.dll |
Weitere Informationen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für