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