GetPrivateObjectSecurity

【勇芳软件工作室】汉化HomePreviousNext

GetPrivateObjectSecurity从受保护的服务器对象的安全描述符中检索信息。

BOOL GetPrivateObjectSecurity(

PSECURITY_DESCRIPTOR 【ObjectDescriptor】,//要查询的SD地址
SECURITY_INFORMATION 【SecurityInformation】,//请求的信息
PSECURITY_DESCRIPTOR 【ResultantDescriptor】,//检索到的SD地址
DWORD 【DescriptorLength】,//检索SD的缓冲区大小
PDWORD 【ReturnLength】// SD缓冲区大小所需的地址
); 

参数

【ObjectDescriptor】

指向SECURITY_DESCRIPTOR结构。这是要查询的安全描述符。

【SecurityInformation】

指定一个SECURITY_INFORMATION结构,用于标识正在请求的安全信息。

【ResultantDescriptor】

指向缓冲区,从指定的安全描述符接收所请求信息的副本。SECURITY_DESCRIPTOR结构以自相关格式返回。

【DescriptorLength】

指定由【ResultantDescriptor】参数指向的缓冲区的大小(以字节为单位)。

【ReturnLength】

指向变量,如果描述符被成功复制,则函数将设置为零。如果缓冲区对于安全描述符来说太小,则该变量将接收所需的字节数。如果该函数返回时该变量的值大于【DescriptorLength】参数的值,则该函数返回FALSE,并且不将任何安全描述符复制到缓冲区。

返回值

如果函数成功,返回值不为零。

如果函数失败,返回值为零。要获取扩展错误信息,请调用GetLastError.

备注

在调用此函数之前,应用程序必须执行适当的访问/权限检查和审核。

也可以看看

CreatePrivateObjectSecurity, DestroyPrivateObjectSecurity, GetFileSecurity, GetKernelObjectSecurity, GetUserObjectSecurity, SECURITY_DESCRIPTOR, SECURITY_INFORMATION, SetPrivateObjectSecurity