Функция обратного вызова SpExportSecurityContextFn (ntsecpkg.h)

  • Статья

Экспорт контекста безопасности в другой процесс.

Функция SpExportSecurityContext — это функция диспетчеризации для функции ExportSecurityContextинтерфейса поставщика поддержки безопасности.

Синтаксис

SpExportSecurityContextFn Spexportsecuritycontextfn;

NTSTATUS Spexportsecuritycontextfn(
  [in]  LSA_SEC_HANDLE phContext,
  [in]  ULONG fFlags,
  [out] PSecBuffer pPackedContext,
  [out] PHANDLE pToken
)
{...}

Параметры

[in] phContext

Дескриптор контекста безопасности для экспорта.

[in] fFlags

Необязательный элемент. Задает параметры дублирования контекста. В следующей таблице перечислены допустимые значения, определенные в Sspi.h.

Значение Значение
SECPKG_CONTEXT_EXPORT_RESET_NEW
 Новый контекст сбрасывается в исходное состояние.
SECPKG_CONTEXT_EXPORT_DELETE_OLD
 Старый контекст удаляется во время экспорта.

[out] pPackedContext

Указатель на структуру SecBuffer, содержащую сериализованный контекст. Ресурсы должны выделяться с помощью функции AllocateClientBuffer и освобождаться вызывающим объектом с помощью функции FreeContextBuffer .

[out] pToken

Необязательный элемент. Указатель на дескриптор, получающий маркер контекста.

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

Если функция выполнена успешно, верните STATUS_SUCCESS.

Если функция завершается сбоем, возвращается код NTSTATUS , указывающий причину сбоя.

Комментарии

Чтобы импортировать ранее экспортированный контекст безопасности, используйте функцию SpImportSecurityContext .

Поставщики общих служб и поставщики услуг должны реализовывать функцию SpExportSecurityContext ; однако фактическое имя, присваиваемого реализации, определяется разработчиком.

Указатель на функцию SpExportSecurityContext доступен в структуре SECPKG_USER_FUNCTION_TABLE , полученной от функции SpUserModeInitialize .

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header ntsecpkg.h

См. также раздел

SECPKG_USER_FUNCTION_TABLE

SpImportSecurityContext

SpUserModeInitialize