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 der angeforderten Sicherheitsbeschreibung empfängt. Dieser Parameter kann NULL sein.

lpcbSecurityDescriptor [in, out]

Ein Zeiger auf eine Variable, der die Größe des Puffers in Bytes angibt, auf den der pSecurityDescriptor-Parameter verweist. Wenn die Funktion zurückgibt, 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, gibt sie einen in Winerror.h definierten Nonzero-Fehlercode zurück. Sie können die FormatMessage-Funktion mit dem flag FORMAT_MESSAGE_FROM_SYSTEM verwenden, um eine generische Beschreibung des Fehlers abzurufen.

Wenn der durch den pSecurityDescriptor-Parameter angegebene Puffer zu klein ist, gibt die Funktion ERROR_INSUFFICIENT_BUFFER zurück, und der lpcbSecurityDescriptor-Parameter enthält die Anzahl von Bytes, die für den angeforderten Sicherheitsdeskriptor erforderlich sind.

Anforderungen

Anforderung	Wert
Verteilbare Komponente	Windows-Offlineregistrierungsbibliothek Version 1.0 oder höher
Header	Offreg.h
DLL	Offreg.dll

Siehe auch

ORDeleteKey

OROpenKey

ORSetKeySecurity

SECURITY_INFORMATION