Funzione RegLoadMUIStringA (winreg.h)

Articolo
11/20/2024

Carica la stringa specificata dalla chiave e dalla sottochiave specificate.

Sintassi

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
);

Parametri

[in] hKey

Handle per una chiave del Registro di sistema aperta. La chiave deve essere stata aperta con il diritto di accesso KEY_QUERY_VALUE. Per altre informazioni, vedere sicurezza delle chiavi del Registro di sistema e diritti di accesso.

Questo handle viene restituito dalla funzione RegCreateKeyEx o RegOpenKeyEx. Può anche essere una delle chiavi predefinite seguenti:

HKEY_CLASSES_ROOT

HKEY_CURRENT_CONFIG

HKEY_CURRENT_USER

HKEY_LOCAL_MACHINE

HKEY_USERS

[in, optional] pszValue

Nome del valore del Registro di sistema.

[out, optional] pszOutBuf

Puntatore a un buffer che riceve la stringa.

Le stringhe del modulo seguente ricevono una gestione speciale:

@[ percorso]\dllname,strID

La stringa con identificatore strID viene caricata da dllname; il percorso è facoltativo. Se il parametro pszDirectory non è NULL, la directory viene anteporta al percorso specificato nei dati del Registro di sistema. Si noti che dllname può contenere variabili di ambiente da espandere.

[in] cbOutBuf

Dimensioni del buffer pszOutBuf in byte.

[out, optional] pcbData

Puntatore a una variabile che riceve le dimensioni dei dati copiati nella pszOutBuf buffer, in byte.

Se il buffer non è sufficientemente grande da contenere i dati, la funzione restituisce ERROR_MORE_DATA e archivia le dimensioni del buffer necessarie nella variabile a cui punta pcbData. In questo caso, il contenuto del buffer non è definito.

[in] Flags

Questo parametro può essere 0 o il valore seguente.

Valore	Significato
REG_MUI_STRING_TRUNCATE 0x00000001	La stringa viene troncata per adattarsi alle dimensioni disponibili del buffer pszOutBuf. Se si specifica questo flag, pcbData deve essere NULL.

[in, optional] pszDirectory

Percorso della directory.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è ERROR_SUCCESS.

Se la funzione ha esito negativo, il valore restituito è un codice di errore di sistema .

Se il buffer pcbData è troppo piccolo per ricevere la stringa, la funzione restituisce ERROR_MORE_DATA.

La versione ANSI di questa funzione restituisce ERROR_CALL_NOT_IMPLEMENTED.

Osservazioni

La funzione RegLoadMUIString è supportata solo per Unicode. Sebbene entrambe le versioni Unicode (W) e ANSI (A) di questa funzione siano dichiarate, la funzione RegLoadMUIStringA restituisce ERROR_CALL_NOT_IMPLEMENTED. Le applicazioni devono chiamare in modo esplicito RegLoadMUIStringW o specificare Unicode come set di caratteri nelle chiamate PInvoke (Platform Invoke).

Per compilare un'applicazione che usa questa funzione, definire _WIN32_WINNT come 0x0600 o versione successiva. Per altre informazioni, vedere Uso delle intestazioni di Windows.

Nota

L'intestazione winreg.h definisce RegLoadMUIString come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista [solo app desktop]
server minimo supportato	Windows Server 2008 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	winreg.h (include Windows.h)
libreria	Advapi32.lib
dll	Advapi32.dll

Vedere anche

funzioni del Registro di sistema

Condividi tramite