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

  • Статья

Функция SpMakeSignature создает сигнатуру на основе указанного сообщения и контекста безопасности.

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

Синтаксис

KspMakeSignatureFn Kspmakesignaturefn;

NTSTATUS Kspmakesignaturefn(
  [in] LSA_SEC_HANDLE ContextId,
  [in] ULONG fQOP,
  [in] PSecBufferDesc Message,
  [in] ULONG MessageSeqNo
)
{...}

Параметры

[in] ContextId

Дескриптор контекста безопасности, который будет использоваться для создания подписи сообщения.

[in] fQOP

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

[in] Message

Указатель на структуру SecBuffer . Во входных данных структура содержит сообщение для подписания.

[in] MessageSeqNo

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

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

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

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

Код возврата Описание
SEC_E_INVALID_HANDLE
 Недопустимый дескриптор.

Комментарии

Аналогом функции SpMakeSignature является функция SpVerifySignature , используемая для проверки подписей на принимающем конце.

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

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

Требования

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

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

MakeSignature

SECPKG_USER_FUNCTION_TABLE

SpUserModeInitialize

SpVerifySignature