![]() |
NSLDeleteRequest |
||||
Header: | NSL.h | Carbon status: | Supported | |
Deletes a lookup request.
NSLError NSLDeleteRequest ( NSLRequestRef ref );
On input, the NSLRequestRef obtained by previously calling NSLPrepareRequest for the lookup request that is to be deleted.
If the value of NSLError.theErr is noErr, the lookup request was deleted. Other possible values are kNSLNotInitialized and kNSLBadReferenceErr.
The NSLDeleteRequest function deletes the specified lookup request and deallocates memory associated with it, including the NSLClientAsyncInfo structure. If a lookup is in progress for the specified lookup request when you call NSLDeleteRequest, the lookup is terminated and any outstanding I/O is lost.
The NSLDeleteRequest function does not deallocate memory associated with the services list or request parameter blocks. To deallocate memory for services lists, call NSLDisposeServicesList; to deallocate memory for parameter blocks, call NSLFreeTypedDataPtr.
© 2000 Apple Computer, Inc. (Last Updated 7/13/2000)