NWDeRegisterNCPExtension(3xti_ncp)


NWDeRegisterNCPExtension -- remove previously registered NCP extension from NetWare Services

Synopsis

#include <ncpx_app.h> 

int NWDeRegisterNCPExtension(void *queryData);

Description

NWDeRegisterNCPExtension removes an NCP extension from the NWS server's list of NCP extensions. If a program has more than one NCP extension registered, it must call NWDeRegisterNCPExtension for each extension that it has registered.

Outstanding NCP extension requests are not guaranteed to complete successfully after NWDeRegisterNCPExtension is called.

When an NCP extension is deregistered, all new requests return with ERR_NO_ITEMS_FOUND, and existing requests may or may not be completed. Those that don't complete also return with the value of ERR_NO_ITEMS_FOUND.

When an NCP extension is registered with either NWRegisterNCPExtension(3xti_ncp) or NWRegisterNCPExtensionByID(3xti_ncp), the address of the queryData pointer is passed as one of the parameters. This pointer is then initialized to point to a 32-byte area of memory in which the service provider can place data. This queryData pointer is used here as a handle for deregistering the NCP extension.

Parameters

(IN) queryData
Specifies the extension handle used to identify the NCP extension.

Return values

0 (0x00)
SUCCESSFUL: the NCP extension was deregistered

255 (0xFF)
ERR_NO_ITEMS_FOUND: the NCP extension has already been deregistered

References

NWRegisterNCPExtension(3xti_ncp), NWRegisterNCPExtensionByID(3xti_ncp)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.