Funzione SHRegDeleteEmptyUSKeyA (shlwapi.h)

Articolo
08/26/2023

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

Sintassi

LSTATUS SHRegDeleteEmptyUSKeyA(
  [in] HUSKEY         hUSKey,
  [in] LPCSTR         pszSubKey,
  [in] SHREGDEL_FLAGS delRegFlags
);

Parametri

[in] hUSKey

Tipo: HUSKEY

Handle per una sottochiave del Registro di sistema attualmente aperta. La sottochiave deve essere stata aperta con il diritto di accesso KEY_SET_VALUE. Per altre informazioni, vedere Sicurezza delle chiavi del Registro di sistema e diritti di accesso.

Questo handle può essere ottenuto tramite la funzione SHRegOpenUSKey .

[in] pszSubKey

Tipo: LPCSTR

Puntatore alla stringa con terminazione null che specifica la sottochiave del Registro di sistema definita dall'utente vuota da eliminare.

[in] delRegFlags

Tipo: SHREGDEL_FLAGS

Una delle SHREGDEL_FLAGS che specifica da quale chiave di base verrà eliminata la sottochiave.

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

Vedi anche

SHRegDeleteUSValue

Condividi tramite