Função SfcIsKeyProtected (sfc.h)

  • Artigo

Determina se a chave do Registro especificada está protegida. Os aplicativos devem evitar a substituição de chaves do Registro protegidas.

Sintaxe

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

Parâmetros

[in] KeyHandle

Um identificador para a chave do Registro raiz. Isso deve ser um identificador para uma das chaves predefinidas a seguir.

HKEY_CLASSES_ROOT

HKEY_CURRENT_USER

HKEY_LOCAL_MACHINE

HKEY_USERS

[in, optional] SubKeyName

Um valor de cadeia de caracteres terminada em nulo que contém o nome da subchave. Essa chave deve ter uma subchave da chave identificada pelo parâmetro hKey . Para obter mais informações sobre nomes de chave, consulte Estrutura do Registro. Se esse parâmetro for NULL, a função verificará apenas se a chave raiz do Registro está protegida.

[in] KeySam

Uma constante que especifica a exibição alternativa do Registro que deve ser usada por aplicativos executados no Windows de 64 bits. Esse sinalizador é ignorado na plataforma x86. Para obter mais informações, consulte Acessando um modo de exibição de registro alternativo.

Valor Significado
0x0000
 Use a chave do Registro de 32 bits de aplicativos de 32 bits e use a chave do Registro de 64 bits de aplicativos de 64 bits.
KEY_WOW64_64KEY
0x0100
 Use a chave do Registro de 64 bits de um aplicativo de 32 bits ou 64 bits.
KEY_WOW64_32KEY
0x0200
 Use a chave do Registro de 32 bits de um aplicativo de 32 bits ou 64 bits.

Valor retornado

Se a chave estiver protegida, o valor retornado será um valor diferente de zero.

Se a chave não estiver protegida, o valor retornado será zero.

Comentários

Uma chave será protegida pelo WRP se o caminho existir e for protegido pelo WRP. A função SfcIsKeyProtected indica que uma subchave é protegida pelo WRP se a subchave tiver uma chave pai protegida pelo WRP.

Por exemplo, se a seguinte chave do Registro existir no sistema e for protegida pelo WRP:

HKEY_LOCAL_MACHINE
   SOFTWARE
      Classes
         Microsoft
            <WinFeature>

A função SfcIsKeyProtected retorna um valor diferente de zero para a subchave a seguir. A nova subchave não precisa existir para a função determinar que ela é protegida por WRP.

HKEY_LOCAL_MACHINE
   SOFTWARE
      Classes
         Microsoft
            <WinFeature>
               <new subkey>

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho sfc.h
Biblioteca Sfc.lib
DLL Sfc.dll

Confira também

SfcIsFileProtected