Función de devolución de llamada KspMakeSignatureFn (ntsecpkg.h)

La función SpMakeSignature genera una firma basada en el contexto de seguridad y el mensaje especificados.

La función SpMakeSignature es la función dispatch de la función MakeSignature de la interfaz del proveedor de compatibilidad de seguridad.

Sintaxis

KspMakeSignatureFn Kspmakesignaturefn;

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

Parámetros

[in] ContextId

Identificador del contexto de seguridad que se va a usar para generar la firma del mensaje.

[in] fQOP

Especifica marcas específicas del paquete que indican la calidad de la protección. Un paquete de seguridad puede usar este parámetro para admitir la selección de algoritmos criptográficos.

[in] Message

Puntero a una estructura SecBuffer . En la entrada, la estructura contiene el mensaje que se va a firmar.

[in] MessageSeqNo

Número de secuencia que se va a asignar al mensaje. Los números de secuencia son opcionales y se usan como protección contra la pérdida y la inserción de mensajes. Un valor de cero indica que los números de secuencia no están en uso.

Valor devuelto

Si la función se ejecuta correctamente, devuelva STATUS_SUCCESS.

Si se produce un error en la función, devuelva un código NTSTATUS que indique el motivo por el que se produjo un error. A continuación se muestra un motivo común de error y el código de error que debe devolver la función.

Código devuelto	Descripción
SEC_E_INVALID_HANDLE	El identificador no es válido.

Comentarios

El homólogo de la función SpMakeSignature es la función SpVerifySignature , que se usa para comprobar las firmas en el extremo receptor.

SSP/AP debe implementar la función SpMakeSignature ; sin embargo, el nombre real proporcionado a la implementación es para el desarrollador.

Hay disponible un puntero a la función SpMakeSignature en la estructura SECPKG_USER_FUNCTION_TABLE recibida de la función SpUserModeInitialize .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	ntsecpkg.h

Consulte también

MakeSignature

SECPKG_USER_FUNCTION_TABLE

SpUserModeInitialize

SpVerifySignature