Carbon


NSLDeleteRequest

Header: NSL.h Carbon status: Supported

Deletes a lookup request.

NSLError NSLDeleteRequest (
    NSLRequestRef ref
);
Parameter descriptions
ref

On input, the NSLRequestRef obtained by previously calling NSLPrepareRequest for the lookup request that is to be deleted.

function result

If the value of NSLError.theErr is noErr, the lookup request was deleted. Other possible values are kNSLNotInitialized and kNSLBadReferenceErr.

DISCUSSION

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)