Функция CopySid (securitybaseapi.h)
Функция CopySid копирует идентификатор безопасности (SID) в буфер.
Синтаксис
BOOL CopySid(
[in] DWORD nDestinationSidLength,
[out] PSID pDestinationSid,
[in] PSID pSourceSid
);
Параметры
[in] nDestinationSidLength
Указывает длину (в байтах) буфера, получающего копию идентификатора безопасности.
[out] pDestinationSid
Указатель на буфер, получающий копию структуры исходного идентификатора безопасности .
[in] pSourceSid
Указатель на структуру sid , которую функция копирует в буфер, на который указывает параметр pDestinationSid .
Возвращаемое значение
Если функция выполняется успешно, возвращается ненулевое значение.
Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.
Комментарии
Приложение может использовать функцию CopySid для создания копии идентификатора безопасности в маркере доступа (например, в TOKEN_GROUPS структуре) для использования в записи управления доступом (ACE).
Примеры
Пример использования этой функции см. в разделе Получение идентификатора безопасности входа.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows XP [классические приложения | Приложения UWP] |
Минимальная версия сервера | Windows Server 2003 [классические приложения | Приложения UWP] |
Целевая платформа | Windows |
Header | securitybaseapi.h (включая Windows.h) |
Библиотека | Advapi32.lib |
DLL | Advapi32.dll |
См. также раздел
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по