CRegKey::GetKeySecurity

Call this method to retrieve a copy of the security descriptor protecting the open registry key.

LONG GetKeySecurity(
   SECURITY_INFORMATION si,
   PSECURITY_DESCRIPTOR psd,
   LPDWORD pnBytes 
) throw( );

Parameters

  • si
    The SECURITY_INFORMATION value that indicates the requested security information.

  • psd
    A pointer to a buffer that receives a copy of the requested security descriptor.

  • pnBytes
    The size, in bytes, of the buffer pointed to by psd.

Return Value

If the method succeeds, the return value is ERROR_SUCCESS. If the method fails, the return value is a nonzero error code is defined in WINERROR.H.

Remarks

For more information, see RegGetKeySecurity.

Requirements

Header: atlbase.h

See Also

Concepts

CRegKey Class

CRegKey Members

CRegKey::SetKeySecurity