Funzione SHRegOpenUSKeyW (shlwapi.h)
Apre una sottochiave del Registro di sistema in un sottoalbero specifico dell'utente (HKEY_CURRENT_USER o HKEY_LOCAL_MACHINE).
Sintassi
LSTATUS SHRegOpenUSKeyW(
LPCWSTR pwzPath,
[in] REGSAM samDesired,
[in, optional] HUSKEY hRelativeUSKey,
[out] PHUSKEY phNewUSKey,
[in] BOOL fIgnoreHKCU
);
Parametri
pwzPath
TBD
[in] samDesired
Tipo: REGSAM
Accesso di sicurezza desiderato. Per altre informazioni sull'accesso alla sicurezza, vedere REGSAM.
[in, optional] hRelativeUSKey
Tipo: HUSKEY
Chiave da utilizzare come base per i percorsi relativi. Se pszPath è un percorso relativo, la chiave specificata sarà relativa a hRelativeUSKey. Se pszPath è un percorso assoluto, impostare hRelativeUSKey su NULL.
[out] phNewUSKey
Tipo: REIMPOSTASKEY
Puntatore all'handle della chiave aperta.
[in] fIgnoreHKCU
Tipo: BOOL
Variabile che specifica la chiave da cercare. Se impostato su TRUE, SHRegOpenUSKey ignora HKEY_CURRENT_USER e restituisce un valore da HKEY_LOCAL_MACHINE.
Valore restituito
Tipo: LSTATUS
Restituisce ERROR_SUCCESS in caso di esito positivo oppure un codice di errore diverso da zero definito in Winerror.h in caso contrario. È possibile usare la funzione FormatMessage con il flag FORMAT_MESSAGE_FROM_SYSTEM per recuperare una descrizione generica dell'errore.
Commenti
Nota
L'intestazione shlwapi.h definisce SHRegOpenUSKey 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 2000 Professional, Windows XP [solo app desktop] |
Server minimo supportato | Windows 2000 Server [solo app desktop] |
Piattaforma di destinazione | Windows |
Intestazione | shlwapi.h |
Libreria | Shlwapi.lib |
DLL | Shlwapi.dll (versione 4.71 o successiva) |