NdisClDeregisterSap function (ndis.h)

NdisClDeregisterSap releases a previously registered SAP.

Syntax

NDIS_STATUS NdisClDeregisterSap(
  [in] NDIS_HANDLE NdisSapHandle
);

Parameters

[in] NdisSapHandle

Specifies the handle returned by NdisClRegisterSap.

Return value

NdisClDeregisterSap can return one of the following:

Return code Description
NDIS_STATUS_PENDING
The call manager's ProtocolCmDeregisterSap function has been called to complete the requested operation. NDIS calls the client's ProtocolClDeregisterSapComplete function when this operation is completed.
NDIS_STATUS_FAILURE
The SAP already is being closed, so this is a redundant call. If NdisClRegisterSap returns anything other than NDIS_STATUS_PENDING, the client should make an internal call to its ProtocolClRegisterSapComplete function.

Remarks

NdisClDeregisterSap releases a SAP on which the client previously registered itself to receive incoming calls with NdisClRegisterSap.

The client should consider the given NdisSapHandle invalid as soon as it calls NdisClDeregisterSap.

Requirements

Requirement Value
Minimum supported client Supported for NDIS 6.0 and NDIS 5.1 drivers (see NdisClDeregisterSap (NDIS 5.1)) in Windows Vista. Supported for NDIS 5.1 drivers (see NdisClDeregisterSap (NDIS 5.1)) in Windows XP.
Target Platform Desktop
Header ndis.h (include Ndis.h)
Library Ndis.lib
IRQL <= DISPATCH_LEVEL
DDI compliance rules Irql_Protocol_Driver_Function(ndis)

See also

NdisClRegisterSap

NdisCmRegisterSapComplete

ProtocolClDeregisterSapComplete

ProtocolCmDeregisterSap

ProtocolUnbindAdapterEx