SfcIsKeyProtected-Funktion (sfc.h)

Bestimmt, ob der angegebene Registrierungsschlüssel geschützt ist. Anwendungen sollten vermeiden, geschützte Registrierungsschlüssel zu ersetzen.

Syntax

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

Parameter

[in] KeyHandle

Ein Handle für den Stammregistrierungsschlüssel. Dies muss ein Handle für einen der folgenden vordefinierten Schlüssel sein.

HKEY_CLASSES_ROOT

HKEY_CURRENT_USER

HKEY_LOCAL_MACHINE

HKEY_USERS

[in, optional] SubKeyName

Ein NULL-terminierter Zeichenfolgenwert, der den Namen des Unterschlüssels enthält. Dieser Schlüssel muss ein Unterschlüssel des Schlüssels sein, der durch den hKey-Parameter identifiziert wird. Weitere Informationen zu Schlüsselnamen finden Sie unter Struktur der Registrierung. Wenn dieser Parameter NULL ist, überprüft die Funktion nur, ob der Stammregistrierungsschlüssel geschützt ist.

[in] KeySam

Eine Konstante, die die alternative Registrierungsansicht angibt, die von Anwendungen verwendet werden soll, die unter 64-Bit-Windows ausgeführt werden. Dieses Flag wird auf der x86-Plattform ignoriert. Weitere Informationen finden Sie unter Zugreifen auf eine alternative Registrierungsansicht.

Wert	Bedeutung
0x0000	Verwenden Sie den 32-Bit-Registrierungsschlüssel aus 32-Bit-Anwendungen und den 64-Bit-Registrierungsschlüssel aus 64-Bit-Anwendungen.
KEY_WOW64_64KEY 0x0100	Verwenden Sie den 64-Bit-Registrierungsschlüssel aus einer 32-Bit- oder 64-Bit-Anwendung.
KEY_WOW64_32KEY 0x0200	Verwenden Sie den 32-Bit-Registrierungsschlüssel aus einer 32-Bit- oder 64-Bit-Anwendung.

Rückgabewert

Wenn der Schlüssel geschützt ist, ist der Rückgabewert ein Nichtzero-Wert.

Wenn der Schlüssel nicht geschützt ist, ist der Rückgabewert 0.

Hinweise

Ein Schlüssel wird durch WRP geschützt, wenn der Pfad vorhanden ist und durch WRP geschützt ist. Die SfcIsKeyProtected-Funktion gibt an, dass ein Unterschlüssel durch WRP geschützt ist, wenn der Unterschlüssel über einen übergeordneten Schlüssel verfügt, der durch WRP geschützt ist.

Beispielsweise, wenn der folgende Registrierungsschlüssel auf dem System vorhanden ist und durch WRP geschützt ist:

HKEY_LOCAL_MACHINE
   SOFTWARE
      Classes
         Microsoft
            <WinFeature>

Die SfcIsKeyProtected-Funktion gibt einen nonzero-Wert für den folgenden Unterschlüssel zurück. Der neue Unterschlüssel muss nicht vorhanden sein, damit die Funktion feststellen kann, dass sie WRP-geschützt ist.

HKEY_LOCAL_MACHINE
   SOFTWARE
      Classes
         Microsoft
            <WinFeature>
               <new subkey>

Anforderungen

Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	sfc.h
Bibliothek	Sfc.lib
DLL	Sfc.dll

Weitere Informationen

SfcIsFileProtected