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
Offreg.h
DLL
Offreg.dll

Weitere Informationen

ORDeleteKey

OROpenKey

ORSetKeySecurity

_SICHERHEITSINFORMATIONEN