| |||
| БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО! | |||
| |||
LookupSecurityDescriptorParts[New - Windows NT] The LookupSecurityDescriptorParts function retrieves security information from a self-relative security descriptor. DWORD LookupSecurityDescriptorParts( PTRUSTEE *pOwner, // receives the owner SID from the security descriptor PTRUSTEE *pGroup, // receives the group SID from the security descriptor PULONG cCountOfAccessEntries, // receives number of access-control entries PEXPLICIT_ACCESS *pListOfAccessEntries, // receives an array of DACL access-control entries PULONG cCountOfAuditEntries, // receives number of audit-control entries PEXPLICIT_ACCESS *pListOfAuditEntries, // receives an array of SACL audit-control entries PSECURITY_DESCRIPTOR pSD // pointer that receives the new security descriptor ); Parameters pOwner Pointer to a variable that receives a pointer to a TRUSTEE structure. The function looks up the name associated with the owner SID in the pSD security descriptor, and returns a pointer to the name in the ptstrName member of the TRUSTEE structure. The function sets the TrusteeForm member to TRUSTEE_IS_NAME. This parameter can be NULL if you are not interested in the name of the owner. pGroup Pointer to a variable that receives a pointer to a TRUSTEE structure. The function looks up the name associated with the primary group SID of the security descriptor, and returns a pointer to the name in the ptstrName member of the TRUSTEE structure. The function sets the TrusteeForm member to TRUSTEE_IS_NAME. This parameter can be NULL if you are not interested in the name of the group. cCountOfAccessEntries Pointer to a ULONG that receives the number of EXPLICIT_ACCESS structures returned in the pListOfAccessEntries array. This parameter can be NULL only if the pListOfAccessEntries parameter is also NULL. pListOfAccessEntries Pointer to a variable that receives a pointer to an array of EXPLICIT_ACCESS structures that describe the ACEs in the DACL of the security descriptor. The TRUSTEE structure in these EXPLICIT_ACCESS structures use the TRUSTEE_IS_NAME form. For a description of how an array of EXPLICIT_ACCESS structures describes the ACEs in an ACL, see the GetExplicitEntriesFromAcl function. If this parameter is NULL, the cCountOfAccessEntries parameter must also be NULL. cCountOfAuditEntries Pointer to a ULONG that receives the number of EXPLICIT_ACCESS structures returned in the pListOfAuditEntries array. This parameter can be NULL only if the pListOfAuditEntries parameter is also NULL. pListOfAuditEntries Pointer to a variable that receives a pointer to an array of EXPLICIT_ACCESS structures that describe the ACEs in the SACL of the security descriptor. The TRUSTEE structure in these EXPLICIT_ACCESS structures uses the TRUSTEE_IS_NAME form. If this parameter is NULL, the cCountOfAuditEntries parameter must also be NULL. pSD Pointer to an existing self-relative security descriptor from which the function retrieves security information. A self-relative security descriptor stores a SECURITY_DESCRIPTOR structure and associated security information in a contiguous block of memory. This differs from an absolute security descriptor, which contains pointers to the associated security information. Return Values If the function succeeds, the return value is ERROR_SUCCESS. If the function fails, the return value is a nonzero error code defined in WINERROR.H. Remarks The LookupSecurityDescriptorParts function retrieves the names of the owner and primary group of the security descriptor. It also returns descriptions of the access-control entries in the DACL and audit-control entries in the SACL of the security descriptor. The parameters other than pSD can be NULL if you are not interested in the information. If you do not want information about the DACL, both pListOfAccessEntries and cCountOfAccessEntries must be NULL. If you do not want information about the SACL, both pListOfAuditEntries and cCountOfAuditEntries must be NULL. Similarly, if you do want DACL or SACL information, both of the corresponding parameters must be non-NULL. You must call the LocalFree function to free any buffers returned by the pOwner, pGroup, pListOfAccessEntries, or pListOfAuditEntries parameters. The LookupSecurityDescriptorParts function is intended for trusted servers that implement or expose security on their own objects. The function works with a self-relative security descriptor suitable for serializing into a stream and storing to disk, as a trusted server might require. See Also ACE, ACL, EXPLICIT_ACCESS, LocalFree, SECURITY_DESCRIPTOR, GetExplicitEntriesFromAcl, SID, TRUSTEE | |||
| Пригласи друзей и счет твоего мобильника всегда будет положительным! | |||
| |||
| Пригласи друзей и счет твоего мобильника всегда будет положительным! | |||
LookupSecurityDescriptorParts[Новый - Windows NT] Функция LookupSecurityDescriptorParts извлекает информацию безопасности из относительного дескриптора безопасности. DWORD LookupSecurityDescriptorParts( PTRUSTEE *pOwner, // ПРИЕМНИКИ владелец SID из дескриптора безопасности PTRUSTEE *pGroup, // приемники группа SID из дескриптора безопасности PULONG cCountOfAccessEntries, // номер приемников имеет доступ к-управляющим данным PEXPLICIT_ACCESS *pListOfAccessEntries, // приемники массив DACL имеет доступ к-управляющим данным PULONG cCountOfAuditEntries, // номер приемников проверять-управляющих данных PEXPLICIT_ACCESS *pListOfAuditEntries, // приемники массив SACL проверять-управляющего указателя данных PSECURITY_DESCRIPTOR pSD //, которые получают новый дескриптор безопасности ); Параметры pOwner Указатель в переменную, которая получает указатель в структуру ПОПЕЧИТЕЛЯ. Функция ищет имя связанное владельцем SID в дескриптор безопасности pSD и возвращает указатель в имя в элементе ptstrName структуры ПОПЕЧИТЕЛЯ. Функция устанавливает элемент TrusteeForm на TRUSTEE_IS_NAME. Этот параметр может быть НЕДЕЙСТВИТЕЛЕН если Вы не заинтересованы в имени владельца. pGroup Указатель в переменную, которая получает указатель в структуру ПОПЕЧИТЕЛЯ. Функция ищет имя связанное первичной группой SID дескриптора безопасности и возвращает указатель в имя в элементе ptstrName структуры ПОПЕЧИТЕЛЯ. Функция устанавливает элемент TrusteeForm на TRUSTEE_IS_NAME. Этот параметр может быть НЕДЕЙСТВИТЕЛЕН если Вы не заинтересованы в имени группы. cCountOfAccessEntries Указатель на ULONG, которое получает число структур EXPLICIT_ACCESS возвращался в массив pListOfAccessEntries. Этот параметр может быть НЕДЕЙСТВИТЕЛЕН только если параметр pListOfAccessEntries также НЕДЕЙСТВИТЕЛЕН. pListOfAccessEntries Указатель в переменную, которая получает указатель в массив структур EXPLICIT_ACCESS, который описывает ПЕР.ТОК в DACL дескриптора безопасности. Структура ПОПЕЧИТЕЛЯ в этом использовании структур EXPLICIT_ACCESS форма TRUSTEE_IS_NAME. Для описания того как массив структур EXPLICIT_ACCESS описывает ПЕР.ТОК в ACL, смотри функцию GetExplicitEntriesFromAcl. Если этот параметр НЕДЕЙСТВИТЕЛЕН, параметр cCountOfAccessEntries должен также быть НЕДЕЙСТВИТЕЛЕН. cCountOfAuditEntries Указатель на ULONG, которое получает число структур EXPLICIT_ACCESS возвращался в массив pListOfAuditEntries. Этот параметр может быть НЕДЕЙСТВИТЕЛЕН только если параметр pListOfAuditEntries также НЕДЕЙСТВИТЕЛЕН. pListOfAuditEntries Указатель в переменную, которая получает указатель в массив структур EXPLICIT_ACCESS, который описывает ПЕР.ТОК в SACL дескриптора безопасности. Структура ПОПЕЧИТЕЛЯ в этих структурах EXPLICIT_ACCESS использует форму TRUSTEE_IS_NAME. Если этот параметр НЕДЕЙСТВИТЕЛЕН, параметр cCountOfAuditEntries должен также быть НЕДЕЙСТВИТЕЛЕН. pSD Указатель в существующий относительный дескриптор безопасности из которого функция извлекает информацию безопасности. Относительный дескриптор безопасности загружает структуру SECURITY_DESCRIPTOR и связавшую информацию безопасности в непрерывном блоке памяти. Это отличается от абсолютного дескриптора безопасности, который содержит указатели в связанную информацию безопасности. Обратные Величины Если функция добивается успеха, обратная величина - ERROR_SUCCESS. Если функция терпит неудачу, обратная величина является ненулевым кодом ошибки определенным в WINERROR.H. Замечания Функция LookupSecurityDescriptorParts извлекает имена владельца и первичной группы дескриптора безопасности. Это также возвращает описания иметь доступ к-управляющим данным в DACL и проверять-управляющих данных в SACL дескриптора безопасности. Параметры кроме pSD могут быть НЕДЕЙСТВИТЕЛЬНЫ если Вы не заинтересованы в информации. Если Вы не хотите информацию о DACL, как pListOfAccessEntries так и cCountOfAccessEntries должен быть НЕДЕЙСТВИТЕЛЕН. Если Вы не хотите информацию о SACL, как pListOfAuditEntries так и cCountOfAuditEntries должен быть НЕДЕЙСТВИТЕЛЕН. Аналогично, если Вы хотите DACL или информация SACL, оба соответствующих параметра должны быть не-НЕДЕЙСТВИТЕЛЬНЫ. Вы должны назвать функцию LocalFree, чтобы освобождать любые буферы возвращанные pOwner, pGroup, pListOfAccessEntries, или параметрами pListOfAuditEntries. Функция LookupSecurityDescriptorParts предназначена для надежных серверов, которые осуществляют или подвергнуты безопасность на своих собственных объектах. Функция работает с относительным дескриптором безопасности пригодным для издания сериями в поток и хранение на диск, как надежный сервер мог потребоваться. Смотри Также АС, ACL, EXPLICIT_ACCESS, LocalFree, SECURITY_DESCRIPTOR, GetExplicitEntriesFromAcl, SID, ПОПЕЧИТЕЛЬ | |||
| |||
 |
