ORGetKeySecurity 函数

检索保护脱机注册表配置单元中指定打开的注册表项的安全描述符的副本。

语法

DWORD ORGetKeySecurity(
  _In_      ORHKEY               Handle,
  _In_      SECURITY_INFORMATION SecurityInformation,
  _Out_opt_ PSECURITY_DESCRIPTOR pSecurityDescriptor,
  _Inout_   PDWORD               lpcbSecurityDescriptor
);

参数

处理 [in]

脱机注册表配置单元中打开的注册表项的句柄。

SecurityInformation [in]

一个SECURITY_INFORMATION值，该值指示请求的安全信息。

pSecurityDescriptor [out， optional]

指向缓冲区的指针，该缓冲区接收请求的安全描述符的副本。 此参数可以为 NULL。

lmicrosoftSecurityDescriptor [in， out]

指向变量的指针，该变量指定 pSecurityDescriptor 参数指向的缓冲区的大小（以字节为单位）。 当函数返回时，变量包含写入缓冲区的字节数。

返回值

如果函数成功，该函数将返回ERROR_SUCCESS。

如果函数失败，它将返回 Winerror.h 中定义的非零错误代码。 可以将 FormatMessage 函数与 FORMAT_MESSAGE_FROM_SYSTEM 标志结合使用来获取错误的常规说明。

如果 pSecurityDescriptor 参数指定的缓冲区太小，则函数将返回ERROR_INSUFFICIENT_BUFFER，并且 lοSecurityDescriptor 参数包含所请求的安全描述符所需的字节数。

要求

要求	值
可再发行组件	Windows 脱机注册表库 1.0 或更高版本
标头	Offreg.h
DLL	Offreg.dll

另请参阅

ORDeleteKey

OROpenKey

ORSetKeySecurity

SECURITY_INFORMATION