Legacy Document

Important: The information in this document is obsolete and should not be used for new development.

Chapter 5 - Notification Manager / Notification Manager Reference

NMRemove
To remove a notification request, use the NMRemove function.
FUNCTION NMRemove (nmReqPtr: NMRecPtr): OSErr;
nmReqPtr
A pointer to a notification record.

DESCRIPTION
The NMRemove function removes the notification request identified by the nmReqPtr parameter from the notification queue and returns a result code.

SPECIAL CONSIDERATIONS
Because NMRemove does not move or purge memory, you can call it from completion routines or interrupt handlers as well as from the main body of an application and from the response procedure of a notification request.

ASSEMBLY-LANGUAGE INFORMATION
The registers on entry and exit for NMRemove are
Registers on entry
A0 Address of NMRec record

Registers on exit
D0 Result code

RESULT CODES
noErr 0 No error
qErr -1 Not in queue
nmTypErr -299 Invalid qType (must be ORD(nmType))

Registers on entry
A0	Address of `NMRec` record

Registers on exit
D0	Result code

Shop the Apple Online Store (1-800-MY-APPLE), visit an Apple Retail Store, or find a reseller.

noErr	0	No error
qErr	-1	Not in queue
nmTypErr	-299	Invalid `qType` (must be `ORD(nmType)`)

Legacy Document

NMRemove

DESCRIPTION

SPECIAL CONSIDERATIONS

ASSEMBLY-LANGUAGE INFORMATION

RESULT CODES noErr0No error qErr-1Not in queue nmTypErr-299Invalid qType (must be ORD(nmType))

RESULT CODES
noErr 0 No error
qErr -1 Not in queue
nmTypErr -299 Invalid `qType` (must be `ORD(nmType)`)