Функция SecLookupWellKnownSid (ntifs.h)

SecLookupWellKnownSid принимает известный тип безопасности (SID) в качестве входных данных и получает идентификатор локальной безопасности (SID) для этого хорошо известного идентификатора безопасности.

Синтаксис

KSECDDDECLSPEC NTSTATUS SEC_ENTRY SecLookupWellKnownSid(
  [in]               WELL_KNOWN_SID_TYPE SidType,
  [out]              PSID                Sid,
  [in]               ULONG               SidBufferSize,
  [in_out, optional] PULONG              SidSize
);

Параметры

[in] SidType

Перечислимый тип, указывающий тип идентификатора безопасности (SID) возвращаемой функции. Этот параметр может быть одним из следующих перечислений для WELL_KNOWN_SID_TYPE.

[out] Sid

Указатель на буфер, который получает структуру идентификатора безопасности , соответствующую параметру sidType . Если этот параметр null, SidBufferSize равно нулю.

[in] SidBufferSize

Переменная, указывающая размер буфера Sid в байтах.

[in_out, optional] SidSize

Необязательный указатель на переменную, указывающую размер буфера Sid. Если функция завершается ошибкой, так как буфер слишком мал или если SidBufferSize равно нулю, эта переменная получает требуемый размер буфера. При успешном выполнении эта переменная содержит размер возвращаемого Sid.

Возвращаемое значение

SecLookupWellKnownSid возвращает STATUS_SUCCESS при успешном выполнении или одном из следующих кодов ошибок при сбое:

Замечания

SecLookupWellKnownSid пытается найти известный идентификатор безопасности с помощью параметра SidType. Помимо поиска известных идентификаторов SID на локальном компьютере, SecLookupWellKnownSid могут искать известные идентификаторы SID на локальном домене. SecLookupWellKnownSidсначала проверяет список известных локальных идентификаторов SID. Если SidType не соответствует локальному хорошо известному идентификатору БЕЗОПАСНОСТИ, функция проверяет наличие известных идентификаторов БЕЗОПАСНОСТИ в основном домене.

Если функция не может найти известный идентификатор БЕЗОПАСНОСТИ для указанного SidType, SecLookupWellKnownSid завершается ошибкой. Это может произойти, если время ожидания сети предотвращает поиск идентификатора безопасности в основном домене. Он также возникает для SidType, которая не имеет соответствующего известного идентификатора БЕЗОПАСНОСТИ.

SecLookupWellKnownSid эквивалентен функции Win32 CreateWellKnownSid. Для приложений в пользовательском режиме перечисление WELL_KNOWN_SID_TYPE определяется в winbase.h.

secLookupWellKnownSid экспортируется драйвером ksecd, который реализует эту функцию с помощью вспомогательных служб пользовательского режима. Соответственно, использование этой функции в файловых системах должно соответствовать обычным правилам обмена данными со службами пользовательского режима. SecLookupWellKnownSid нельзя использовать во время ввода-вывода файла на разбиении.

Требования

См. также

SID

SecLookupAccountName

SecLookupAccountSid