Funzione RegLoadMUIStringA (winreg.h)
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.
[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 |