RegLoadMUIStringA-Funktion (winreg.h)

Artikel
03/04/2024

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.

Wert	Bedeutung
REG_MUI_STRING_TRUNCATE 0x00000001	Die Zeichenfolge wird abgeschnitten, um der verfügbaren Größe des pszOutBuf-Puffers zu entsprechen. Wenn dieses Flag angegeben ist, muss pcbDataNULL 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

Registrierungsfunktionen

Share via