Функция 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.
-
lpcbSecurityDescriptor [in, out]
-
Указатель на переменную, указывающую размер (в байтах) буфера, на который указывает параметр pSecurityDescriptor . При возврате функции переменная содержит количество байтов, записанных в буфер.
Возвращаемое значение
Если функция завершается успешно, функция возвращает ERROR_SUCCESS.
Если функция завершается сбоем, она возвращает ненулевой код ошибки, определенный в Winerror.h. Чтобы получить общее описание ошибки, можно использовать функцию FormatMessage с флагом FORMAT_MESSAGE_FROM_SYSTEM.
Если буфер, заданный параметром pSecurityDescriptor , слишком мал, функция возвращает ERROR_INSUFFICIENT_BUFFER, а параметр lpcbSecurityDescriptor содержит количество байтов, необходимое для запрошенного дескриптора безопасности.
Требования
| Требование | Значение |
|---|---|
| Распространяемые компоненты |
Библиотека автономного реестра Windows версии 1.0 или более поздней |
| Заголовок |
|
| DLL |
|
См. также раздел