Funzione RegLoadMUIStringA (winreg.h)

  • Articolo

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 e diritti di accesso delle chiavi del Registro di sistema.

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:

@[path]\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 nel buffer pszOutBuf , 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 questo flag viene specificato, pcbData deve essere NULL.

[in, optional] pszDirectory

Percorso della directory.

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene 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.

Commenti

La funzione RegLoadMUIString è supportata solo per Unicode. Anche se entrambe le versioni Unicode (W) e ANSI (A) di questa funzione sono 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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione winreg.h (include Windows.h)
Libreria Advapi32.lib
DLL Advapi32.dll

Vedi anche

Funzioni del Registro di sistema