Funzione SHRegOpenUSKeyA (shlwapi.h)

Apre una sottochiave del Registro di sistema in un sottoalbero specifico dell'utente (HKEY_CURRENT_USER o HKEY_LOCAL_MACHINE).

Sintassi

LSTATUS SHRegOpenUSKeyA(
  [in]           LPCSTR  pszPath,
  [in]           REGSAM  samDesired,
  [in, optional] HUSKEY  hRelativeUSKey,
  [out]          PHUSKEY phNewUSKey,
  [in]           BOOL    fIgnoreHKCU
);

Parametri

[in] pszPath

Tipo: LPCTSTR

Puntatore a una stringa con terminazione null con il nome della sottochiave.

[in] samDesired

Tipo: REGSAM

Accesso alla sicurezza desiderato. Per altre informazioni sull'accesso alla sicurezza, vedere REGSAM.

[in, optional] hRelativeUSKey

Tipo: HUSKEY

Chiave da usare come base per i percorsi relativi. Se pszPath è un percorso relativo, la chiave che specifica sarà relativa a hRelativeUSKey. Se pszPath è un percorso assoluto, impostare hRelativeUSKey su NULL.

[out] phNewUSKey

Tipo: PHUSKEY

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 se ha esito positivo o 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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

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)