Función NdisCoDeleteVc (ndis.h)

Artículo
03/05/2024

NdisCoDeleteVc destruye un VC creado por el autor de la llamada.

Sintaxis

NDIS_STATUS NdisCoDeleteVc(
  [in] NDIS_HANDLE NdisVcHandle
);

Parámetros

[in] NdisVcHandle

Especifica el identificador que identifica la credencial verificable que se va a eliminar. El autor de la llamada obtuvo originalmente este identificador de NdisCoCreateVc.

Valor devuelto

NdisCoDeleteVc puede devolver una de las siguientes opciones:

Código devuelto	Descripción
NDIS_STATUS_SUCCESS	NDIS eliminó la credencial verificable.
NDIS_STATUS_NOT_ACCEPTED	La credencial verificable sigue activa, por lo que no se pudo eliminar.
NDIS_STATUS_CLOSING	Esta llamada es redundante, pero la desactivación en la credencial verificable especificada sigue pendiente.

Comentarios

Cuando un protocolo llama a NdisCoDeleteVc, no debe haber llamadas pendientes en el VC especificado y que vc ya se haya desactivado. Para cumplir estos requisitos implica que las condiciones siguientes contienen:

Si un cliente local inició la anulación de la llamada, ese cliente ya ha llamado a NdisClCloseCall con el NdisVcHandle dado y su solicitud de llamada de cierre se ha completado correctamente.
Si un cliente remoto inició la anulación de la llamada, el administrador de llamadas independiente ya ha llamado a NdisCmDeactivateVc con el NdisVcHandle dado y su solicitud de desactivación se ha completado correctamente.

Solo el protocolo que creó una credencial verificable determinada puede eliminar esa credencial verificable. Una llamada a NdisCoDeleteVc hace que NDIS llame tanto a la función MiniportCoDeleteVc del controlador de miniport subyacente como a la función ProtocolCoDeleteVc del cliente o administrador de llamadas con el que el autor de la llamada comparte NdisVcHandle .

Cuando NdisCoDeleteVc devuelve el control , NdisVcHandle ya no es válido.

Los administradores de llamadas independientes, que se registran con NDIS como controladores de protocolo, pueden llamar a NdisCoDeleteVc. Los controladores de minipuerto orientados a la conexión que proporcionan compatibilidad integrada con la administración de llamadas llaman a NdisMCmDeleteVc en su lugar.

Requisitos

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