ORGetKeySecurity-Funktion
Ruft eine Kopie der Sicherheitsbeschreibung ab, die den angegebenen offenen Registrierungsschlüssel in einer Offlineregistrierungsstruktur schützt.
Syntax
DWORD ORGetKeySecurity(
_In_ ORHKEY Handle,
_In_ SECURITY_INFORMATION SecurityInformation,
_Out_opt_ PSECURITY_DESCRIPTOR pSecurityDescriptor,
_Inout_ PDWORD lpcbSecurityDescriptor
);
Parameter
-
Handle [ In]
-
Ein Handle für einen geöffneten Registrierungsschlüssel in einer Offlineregistrierungsstruktur.
-
SecurityInformation [ In]
-
Ein SECURITY _ INFORMATION-Wert, der die angeforderten Sicherheitsinformationen angibt.
-
pSecurityDescriptor [ out, optional]
-
Ein Zeiger auf einen Puffer, der eine Kopie des angeforderten Sicherheitsdeskriptors empfängt. Dieser Parameter kann NULL sein.
-
lpcbSecurityDescriptor [ in, out]
-
Ein Zeiger auf eine Variable, die die Größe des Puffers in Bytes angibt, auf den der pSecurityDescriptor-Parameter zeigt. Wenn die Funktion zurückgegeben wird, enthält die Variable die Anzahl der bytes, die in den Puffer geschrieben wurden.
Rückgabewert
Wenn die Funktion erfolgreich ist, gibt die Funktion ERROR _ SUCCESS zurück.
Wenn die Funktion fehlschlägt, wird ein Fehlercode ungleich 0 (null) zurückgegeben, der in "Winerror.h" definiert ist. Sie können die FormatMessage-Funktion mit dem _ FORMAT MESSAGE FROM _ _ SYSTEM-Flag verwenden, um eine generische Beschreibung des Fehlers abzurufen.
Wenn der vom pSecurityDescriptor-Parameter angegebene Puffer zu klein ist, gibt die Funktion ERROR INSUFFICIENT BUFFER zurück, _ _ und der lpcbSecurityDescriptor-Parameter enthält die Anzahl der Bytes, die für den angeforderten Sicherheitsdeskriptor erforderlich sind.
Anforderungen
| Anforderung | Wert |
|---|---|
| Verteilbare Komponente |
Windows Offline registry library version 1.0 or later (Offlineregistrierungsbibliothek, Version 1.0 oder höher) |
| Header |
|
| DLL |
|