Leer en inglés

Compartir a través de


Función NdisClGetProtocolVcContextFromTapiCallId (ndis.h)

NdisClGetProtocolVcContextFromTapiCallId recupera el contexto de cliente de una conexión virtual (VC) identificada por una cadena de identificador de llamada TAPI.

Sintaxis

NDIS_STATUS NdisClGetProtocolVcContextFromTapiCallId(
  [in]  UNICODE_STRING TapiCallId,
  [out] PNDIS_HANDLE   ProtocolVcContext
);

Parámetros

[in] TapiCallId

Cadena Unicode que identifica una vc determinada. Esta cadena es la versión Unicode de un identificador de cadena devuelto previamente por la función NdisCoGetTapiCallID .

[out] ProtocolVcContext

Puntero a un NDIS_HANDLE asignado por el autor de la llamada que recibe un identificador para el contexto de cliente para la credencial verificable. El cliente proporcionó este contexto a NDIS de vuelta desde su controlador ProtocolCoCreateVc .

Valor devuelto

Devuelve uno de los siguientes valores de estado:

Código devuelto Descripción
NDIS_STATUS_SUCCESS
NDIS recuperó correctamente el identificador para el contexto de VC del cliente para el VC identificado por la cadena de identificador de llamada TAPI.
NDIS_STATUS_FAILURE
Error al intentar recuperar el identificador al contexto de VC del cliente.

Comentarios

Supongamos que un administrador de llamadas llama a NdisCoCreateVc para crear un VC para una llamada TAPI. A su vez, NDIS proporciona el identificador para la credencial verificable a un cliente. El cliente pasa este identificador de VC en una llamada a la función NdisCoGetTapiCallId para recuperar un identificador de cadena para la credencial verificable. A continuación, el cliente puede presentar este identificador como una cadena Unicode a NdisClGetProtocolVcContextFromTapiCallId para recuperar su contexto para la credencial verificable.

El cliente crea un contexto para cada vc que administra. El cliente usa NdisCoGetTapiCallId para recuperar un identificador de cadena para cada vc. El cliente pasa cada identificador de cadena a una aplicación TAPI para identificar cada vc. Más adelante, si una aplicación TAPI pasa uno de estos identificadores de cadena al cliente en una operación relacionada con VC, el cliente debe pasar este identificador de cadena como una cadena Unicode en una llamada a NdisClGetProtocolVcContextFromTapiCallId para obtener el contexto correcto para la credencial verificable.

Consulte la estructura UNICODE_STRING para obtener más información.

Requisitos

Requisito Value
Cliente mínimo compatible Compatible con controladores NDIS 6.0 y NDIS 5.1 (consulte NdisClGetProtocolVcContextFromTapiCallId (NDIS 5.1)) en Windows Vista. Compatible con los controladores NDIS 5.1 (consulte NdisClGetProtocolVcContextFromTapiCallId (NDIS 5.1)) en Windows XP.
Plataforma de destino Escritorio
Encabezado ndis.h (incluya Ndis.h)
Library Ndis.lib
IRQL DISPATCH_LEVEL
Reglas de cumplimiento de DDI Irql_Protocol_Driver_Function(ndis)

Consulte también

NdisCoCreateVc

NdisCoGetTapiCallId

UNICODE_STRING