Función NdisCoGetTapiCallId (ndis.h)

NdisCoGetTapiCallId recupera una cadena que las aplicaciones TAPI pueden usar para identificar una conexión virtual NDIS determinada (VC).

Sintaxis

NDIS_STATUS NdisCoGetTapiCallId(
  [in]      NDIS_HANDLE NdisVcHandle,
  [in, out] PVAR_STRING TapiCallId
);

Parámetros

[in] NdisVcHandle

Especifica el identificador NDIS para la credencial verificable. Este identificador lo proporcionó NDIS cuando la credencial verificable se creó originalmente con la función NdisCoCreateVc .

[in, out] TapiCallId

Puntero a un búfer asignado por el autor de la llamada que recibe una estructura de datos de tipo VAR_STRING. Tras la devolución correcta, esta estructura describe una cadena que las aplicaciones TAPI pueden usar para identificar la credencial verificable.

Valor devuelto

Devuelve uno de los siguientes valores de estado:

Código devuelto	Descripción
NDIS_STATUS_SUCCESS	NDIS devolvió correctamente un identificador de cadena para la credencial verificable.
NDIS_STATUS_BUFFER_TOO_SHORT	El miembro ulTotalSize de la estructura VAR_STRING especifica que el tamaño del búfer no es lo suficientemente grande como para contener la cadena que identifica la credencial verificable. NdisCoGetTapiCallId establece el miembro ulNeededSize de la estructura VAR_STRING en bytes.
NDIS_STATUS_INVALID_DATA	El identificador de la credencial verificable especificada por NdisVcHandle no es válido.

Comentarios

Supongamos que un administrador de llamadas llama a NdisCoCreateVc para crear una credencial verificable para una llamada TAPI. NDIS a su vez proporciona el identificador a la credencial verificable a un cliente. El cliente pasa este identificador vc en una llamada a la función NdisCoGetTapiCallId para recuperar una cadena que identifica la credencial verificable. El cliente puede pasar este identificador de cadena a una aplicación TAPI para identificar 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 credencial verificable. 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.

Para obtener más información sobre la estructura de VAR_STRING, vea Objetos TAPI.

Requisitos

Requisito	Value
Cliente mínimo compatible	Compatible con los controladores NDIS 6.0 y NDIS 5.1 (consulta NdisCoGetTapiCallId (NDIS 5.1)) en Windows Vista. Compatible con los controladores NDIS 5.1 (consulta NdisCoGetTapiCallId (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_Connection_Function(ndis)

Consulte también

NdisClGetProtocolVcContextFromTapiCallId

NdisCoCreateVc