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

  • Artículo

Envía metadatos a un proveedor de soporte técnico de seguridad. Los metadatos enviados por esta función se obtienen mediante una llamada anterior a la función SpQueryMetaDataFn .

Sintaxis

SpExchangeMetaDataFn Spexchangemetadatafn;

NTSTATUS Spexchangemetadatafn(
  [in]           LSA_SEC_HANDLE CredentialHandle,
  [in, optional] PUNICODE_STRING TargetName,
  [in]           ULONG ContextRequirements,
  [in]           ULONG MetaDataLength,
  [in]           PUCHAR MetaData,
  [in, out]      PLSA_SEC_HANDLE ContextHandle
)
{...}

Parámetros

[in] CredentialHandle

Identificador de las credenciales que se van a usar para el contexto de seguridad. Si el parámetro ContextHandle apunta a NULL en la entrada, esta función usa el valor de este parámetro para crear un contexto de seguridad.

El valor de este parámetro no puede ser NULL si el parámetro ContextHandle apunta a NULL en la entrada.

[in, optional] TargetName

Puntero a un UNICODE_STRING que contiene el nombre del destino del contexto.

[in] ContextRequirements

Marcas que indican los atributos de contexto requeridos por el cliente.

Estos son los valores válidos. Los valores se pueden combinar mediante una operación OR lógica.

Valor Significado
ISC_REQ_DELEGATE
 El servidor puede suplantar al cliente.
ISC_REQ_MUTUAL_AUTH
 Tanto el cliente como el servidor son necesarios para demostrar su identidad.
ISC_REQ_REPLAY_DETECT
 El contexto de seguridad admitirá la detección de paquetes reproducidos.
ISC_REQ_SEQUENCE_DETECT
 El contexto de seguridad admitirá la detección de mensajes desordenados.
ISC_REQ_USE_SESSION_KEY
 Se debe negociar una nueva clave de sesión .
ISC_REQ_PROMPT_FOR_CREDS
 Si el cliente es un usuario interactivo, el paquete debe, si es posible, solicitar al usuario las credenciales adecuadas.
ISC_REQ_USE_SUPPLIED_CREDS
 El búfer de entrada contiene información de credenciales específicas del paquete que se debe usar para autenticar la conexión.
ISC_REQ_ALLOCATE_MEMORY
 El paquete debe asignar memoria. El autor de la llamada debe llamar finalmente a la función FreeContextBuffer para liberar memoria asignada por el paquete.
ISC_REQ_USE_DCE_STYLE
 El autor de la llamada espera una transacción de autenticación mutua de tres patas.
ISC_REQ_DATAGRAM
 Se debe usar un canal de comunicaciones de tipo datagrama. Para obtener más información, vea Contextos de datagrama.
ISC_REQ_CONNECTION
 Se debe usar un canal de comunicaciones de tipo de conexión. Para obtener más información, vea Contextos orientados a conexiones.
ISC_REQ_EXTENDED_ERROR
 Si se produce un error en el contexto, genere un mensaje de respuesta de error para devolverlo al cliente.
ISC_REQ_STREAM
 Se debe usar un canal de comunicaciones de tipo de flujo. Para obtener más información, consulte Stream Contextos.
ISC_REQ_INTEGRITY
 Se comprueba la integridad del búfer; Sin embargo, no se detectarán mensajes reproducidos y fuera de secuencia.

[in] MetaDataLength

Tamaño, en caracteres, del búfer de MetaData .

[in] MetaData

Metadatos que se van a enviar.

[in, out] ContextHandle

Identificador del identificador de seguridad que se va a usar. Si este parámetro apunta a NULL en la entrada, esta función asigna e inicializa un contexto de seguridad mediante los valores de los parámetros CredentialHandle y TargetName .

Si este parámetro apunta a NULL en la entrada, CredentialHandle no puede ser NULL.

Valor devuelto

Si la función se ejecuta correctamente, devuelva STATUS_SUCCESS o un código de estado informativo.

Si se produce un error en la función, devuelva un código de error NTSTATUS que indique el motivo por el que se produjo un error. Para obtener más información, vea la sección Comentarios.

Comentarios

Hay disponible un puntero a la función SpExchangeMetaDataFn en la estructura SECPKG_FUNCTION_TABLE recibida de la función SpLsaModeInitialize .

Requisitos

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