RegLoadMUIStringA-Funktion (winreg.h)

Artikel
11/20/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 zu einem geöffneten Registrierungsschlüssel. Der Schlüssel muss mit dem zugriffsrecht KEY_QUERY_VALUE geöffnet worden sein. Weitere Informationen finden Sie unter Registry Key Security and Access Rights.

Dieses Handle wird von der RegCreateKeyEx-- oder RegOpenKeyEx--Funktion zurückgegeben. Es kann auch einer der folgenden vordefinierten Schlüsselsein:

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 des folgenden Formulars erhalten eine spezielle Behandlung:

@[Pfad]\dllname,-strID

Die Zeichenfolge mit bezeichner strID wird aus dllnamegeladen; der Pfad optional ist. Wenn der pszDirectory Parameter nicht NULL-ist, wird das Verzeichnis dem in den Registrierungsdaten angegebenen Pfad vorangestellt. Beachten Sie, dass dllname Umgebungsvariablen enthalten kann, die erweitert werden sollen.

[in] cbOutBuf

Die Größe des pszOutBuf Puffers in Byte.

[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 durch pcbData-verwiesen wird. In diesem Fall sind die Inhalte 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 die verfügbare Größe des pszOutBuf Puffers anzupassen. Wenn dieses Kennzeichen angegeben ist, muss pcbData-NULL-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.

Bemerkungen

Die RegLoadMUIString--Funktion wird nur für Unicode unterstützt. Obwohl unicode (W) und ANSI (A)-Versionen dieser Funktion deklariert werden, gibt die RegLoadMUIStringA--Funktion ERROR_CALL_NOT_IMPLEMENTED zurück. Anwendungen sollten explizit RegLoadMUIStringW- aufrufen oder Unicode als Zeichensatz in Plattformaufrufen (PInvoke) 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.

Anmerkung

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
mindestens unterstützte Client-	Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2008 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	winreg.h (enthalten Windows.h)
Library	Advapi32.lib
DLL-	Advapi32.dll

Siehe auch

Registrierungsfunktionen

Freigeben über