![]() |
NSLStandardDeregisterURL |
||||
Header: | NSL.h | Carbon status: | Supported | |
Deregisters a service registered by NSLStandardRegisterURL.
NSLError NSLStandardDeregisterURL ( NSLPath urlToDeregister, NSLNeighborhood neighborhoodToDeregisterIn );
On input, a value of type NSLPath specifying the URL that is to be deregistered.
On input, a value of type NSLNeighborhood specifying the neighborhood in which to deregister the service, or NULL. If NULL, the plug-ins that handle the service specified by urlToRegister determine the neighborhood from which the service is deregistered.
If the value returned by NSLStandardDeregisterURL is noErr, the service was deregistered. The NSLStandardDeregisterURL function returns kNSLNoSupportForService, which indicates that none of the currently installed plug-ins support the service for which deregistration is requested or dont support registration at all. Other possible errors include kNSLNotInitialized.
The NSLStandardDeregisterURL function deregisters the service specified by urlToDeregister. You should call NSLStandardDeregisterURL as part of your standard shutdown procedure for services that your application registered by calling NSLStandardRegisterURL.
NSLStandardDeregisterURL returns kNSLBadURLSyntax if urlToDeregister contains illegal characters. If portions of the URL that you are deregistering contain illegal characters, call NSLHexEncodeText NSLHexEncodeText to encode the illegal characters before you call NSLStandardDeregisterURL.
The NSLStandardDeregisterURL function is available in NSL 1.1 and later, and supersedes the NSLRegisterService function, which was provided in NSL 1.0.
© 2000 Apple Computer, Inc. (Last Updated 7/13/2000)