Funzione SfcIsKeyProtected (sfc.h)

Articolo
03/15/2023

Determina se la chiave del Registro di sistema specificata è protetta. Le applicazioni devono evitare di sostituire le chiavi del Registro di sistema protette.

Sintassi

BOOL SfcIsKeyProtected(
  [in]           HKEY    KeyHandle,
  [in, optional] LPCWSTR SubKeyName,
  [in]           REGSAM  KeySam
);

Parametri

[in] KeyHandle

Handle alla chiave del Registro di sistema radice. Questo deve essere un handle per una delle chiavi predefinite seguenti.

HKEY_CLASSES_ROOT

HKEY_CURRENT_USER

HKEY_LOCAL_MACHINE

HKEY_USERS

[in, optional] SubKeyName

Valore stringa con terminazione null contenente il nome della sottochiave. Questa chiave deve essere una sottochiave della chiave identificata dal parametro hKey . Per altre informazioni sui nomi delle chiavi, vedere Struttura del Registro di sistema. Se questo parametro è NULL, la funzione controlla solo se la chiave del Registro di sistema radice è protetta.

[in] KeySam

Costante che specifica la visualizzazione del Registro di sistema alternativa che deve essere usata dalle applicazioni eseguite in Windows a 64 bit. Questo flag viene ignorato nella piattaforma x86. Per altre informazioni, vedere Accesso a una visualizzazione registro alternativo.

Valore	Significato
0x0000	Usare la chiave del Registro di sistema a 32 bit da applicazioni a 32 bit e usare la chiave del Registro di sistema a 64 bit da applicazioni a 64 bit.
KEY_WOW64_64KEY 0x0100	Usare la chiave del Registro di sistema a 64 bit da un'applicazione a 32 bit o a 64 bit.
KEY_WOW64_32KEY 0x0200	Usare la chiave del Registro di sistema a 32 bit da un'applicazione a 32 bit o a 64 bit.

Valore restituito

Se la chiave è protetta, il valore restituito è un valore diverso da zero.

Se la chiave non è protetta, il valore restituito è zero.

Commenti

Una chiave è protetta da WRP se il percorso esiste ed è protetto da WRP. La funzione SfcIsKeyProtected indica che una sottochiave è protetta da WRP se la sottochiave ha una chiave padre protetta da WRP.

Ad esempio, se la chiave del Registro di sistema seguente esiste nel sistema ed è protetta da WRP:

HKEY_LOCAL_MACHINE
   SOFTWARE
      Classes
         Microsoft
            <WinFeature>

La funzione SfcIsKeyProtected restituisce un valore diverso da zero per la sottochiave seguente. La nuova sottochiave non deve esistere per la funzione per determinare che è protetta da WRP.

HKEY_LOCAL_MACHINE
   SOFTWARE
      Classes
         Microsoft
            <WinFeature>
               <new subkey>

Requisiti


Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	sfc.h
Libreria	Sfc.lib
DLL	Sfc.dll

Vedi anche

SfcIsFileProtected