Document Revision History

These functions now have descriptions: AEPutKeyDesc, AEPutKeyPtr, AEDeleteKeyDesc, AEGetKeyDesc, AEGetKeyPtr, and AESizeOfKeyDesc.

These constants now have descriptions: keyAELaunchedAsLogInItem and keyAELaunchedAsServiceItem in “Launch Apple Event Constants”; and typeUInt16 and typeUInt64 in “Numeric Descriptor Type Constants”.

In “Descriptor Type Constants,” clarified description for typeFileURL and added note to Discussion section about working with Fast User Switching.

Added Version Notes section to AEResetTimer, noting that prior to Mac OS X version 10.3, calling that function did not reset the timeout value.

In the Discussion sections for AEGetDescData and AEGetDescDataSize, noted that you can only use these functions with value descriptors created by AECreateDesc.

For the functions in “Suspending and Resuming Apple Event Handling,” noted that they should be called only on the main thread.

Added Special Considerations section for the function AESendMessage, describing a potential bug and providing a link to a sample code work-around.

Added information to “Introduction to Apple Event Manager Reference” about thread safety, about forcing a connection to the window server, and about the location of the AE framework (now a subframework of the CoreServices framework). Also added a link to AppleScript Terminology and Apple Event Codes Reference.

Added enumeration “kTSMHiliteCaretPosition,” and noted that starting in Mac OS X version 10.4, you should use constants from that enumeration, rather than from “kCaretPosition.”

In “Descriptor Type Constants,” added note that a descriptor of type typeFileURL doesn't represent a CFURL, it represents a C-string-style file path.

Added documentation for the constants in the enum “typeUnicodeText”, including the new constants typeUTF16ExternalRepresentation and typeUTF8Text. See important information in the Version Notes section.

Added documentation for the constant kAEOpenContents in the section “Event ID Constants.” This constant is new in Mac OS X v10.4.

Added documentation for the constant keyAESearchText in the enum “keyAEPropData.” This constant is new in Mac OS X v10.4.

For a number of functions and data types, added links to related information in new document Apple Events Programming Guide.

Added missing descriptions for the constants typeFSRef and typeFileURL in the section “Descriptor Type Constants.”

Filled in missing descriptions for some constants in “Apple Event Manager Result Codes.”

Added documentation for the constant keyReplyRequestedAttr in the section “Keyword Attribute Constants.”

Made minor changes to introductory text in “Apple Event Manager Functions.”

Added Version Notes sections to AEBuildAppleEventand AEBuildDesc, noting that prior to Mac OS X version 10.3, these functions would fail if you supplied a data parameter with size greater than 32767 bytes.

Added Description section for “typeApplicationBundleID”.

Deleted duplicate definition of constant typeApplicationURL, leaving only the one in “Descriptor Type Constants.”

Noted that the functions AEGetParamDesc and AEGetParamPtr work with Apple event records (type AERecord), as well as with Apple events (type AppleEvent).

Reduced use of the word “record,” which often appeared gratuitously with data structures that were converted from Pascal record types long ago.

In the function call example in the description of the AEEventSource typedef, changed the call to use sizeof (AEEventSource).

Added note on use of pointer-based and descriptor-based coercion handlers to AECoercePtr. This information applies to Mac OS X version 10.2 and later.

Added a missing “&” to the function call example in the description of the AEEventSource typedef.

Added callback, constant, data type, and function descriptions for obtaining a list of remote processes with the remote process resolver mechanism.

Added descriptions for these functions: AECreateRemoteProcessResolver, AEDisposeRemoteProcessResolver, AERemoteProcessResolverGetProcesses, AERemoteProcessResolverScheduleWithRunLoop

Added description for this callback: AERemoteProcessResolverCallback

Added descriptions for these data types: AERemoteProcessResolverContext, AERemoteProcessResolverRef

Added descriptions for these constants: kAERemoteProcessURLKey, kAERemoteProcessNameKey, kAERemoteProcessUserIDKey, kAERemoteProcessProcessIDKey, typeApplicationURL, “typeKernelProcessID”, “typeMachPort”

Added thread safety information for many Apple Event Manager functions.

Reordered some constants that were not in alphabetical order.

Updated formatting.