Función SfcIsKeyProtected (sfc.h)

Determina si la clave del Registro especificada está protegida. Las aplicaciones deben evitar reemplazar las claves del Registro protegidas.

Sintaxis

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

Parámetros

[in] KeyHandle

Identificador de la clave del Registro raíz. Debe ser un identificador de una de las siguientes claves predefinidas.

HKEY_CLASSES_ROOT

HKEY_CURRENT_USER

HKEY_LOCAL_MACHINE

HKEY_USERS

[in, optional] SubKeyName

Valor de cadena terminada en NULL que contiene el nombre de la subclave. Esta clave debe ser una subclave de la clave identificada por el parámetro hKey . Para obtener más información sobre los nombres de clave, vea Estructura del Registro. Si este parámetro es NULL, la función solo comprueba si la clave del Registro raíz está protegida.

[in] KeySam

Constante que especifica la vista del Registro alternativa que deben usar las aplicaciones que se ejecutan en Windows de 64 bits. Esta marca se omite en la plataforma x86. Para obtener más información, consulte Acceso a una vista del Registro alternativa.

Value	Significado
0x0000	Use la clave del Registro de 32 bits de aplicaciones de 32 bits y use la clave del Registro de 64 bits de aplicaciones de 64 bits.
KEY_WOW64_64KEY 0x0100	Use la clave del Registro de 64 bits de una aplicación de 32 o 64 bits.
KEY_WOW64_32KEY 0x0200	Use la clave del Registro de 32 bits de una aplicación de 32 o 64 bits.

Valor devuelto

Si la clave está protegida, el valor devuelto es un valor distinto de cero.

Si la clave no está protegida, el valor devuelto es cero.

Comentarios

Una clave está protegida por WRP si la ruta de acceso existe y está protegida por WRP. La función SfcIsKeyProtected indica que wrP protege una subclave si la subclave tiene una clave primaria protegida por WRP.

Por ejemplo, si existe la siguiente clave del Registro en el sistema y está protegida por WRP:

HKEY_LOCAL_MACHINE
   SOFTWARE
      Classes
         Microsoft
            <WinFeature>

La función SfcIsKeyProtected devuelve un valor distinto de cero para la siguiente subclave. La nueva subclave no necesita existir para que la función determine que está protegida por WRP.

HKEY_LOCAL_MACHINE
   SOFTWARE
      Classes
         Microsoft
            <WinFeature>
               <new subkey>

Requisitos

Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	sfc.h
Library	Sfc.lib
Archivo DLL	Sfc.dll

Consulte también

SfcIsFileProtected