AEStreamWriteKey(_:_:)

Declaration

func AEStreamWriteKey(_ ref: AEStreamRef!, _ key: AEKeyword) -> OSStatus

Parameters

• ref:

  An Aestreamref containing the stream data.

• key:

  The AEKeyword associated with the new descriptor being added to the stream. See Aekeyword.

Return Value

A result code. See Result Codes.

Discussion

You must follow this call with a sequence of “AEStream” calls to specify exactly one descriptor that goes with the keyword. The descriptor you create can be of type AEDesc, AEDescList, or AERecord.

If you are creating nested descriptors, this routine begins a new keyword/descriptor pair for the descriptor most recently opened by a call to AEStreamWriteKey(_:_:) or AEStreamOpenEvent(_:). You cannot use this routine to write parameters to any other types of descriptors, even if they are nested inside of an AERecord.

See Also

Creating Apple Event Structures Using Streams

• AEStreamClose(_:_:)
• AEStreamCloseDesc(_:)
• AEStreamCloseList(_:)
• AEStreamCloseRecord(_:)
• AEStreamCreateEvent(_:_:_:_:_:_:_:)
• AEStreamOpen()
• AEStreamOpenDesc(_:_:)
• AEStreamOpenEvent(_:)
• AEStreamOpenKeyDesc(_:_:_:)
• AEStreamOpenList(_:)
• AEStreamOpenRecord(_:_:)
• AEStreamOptionalParam(_:_:)
• AEStreamSetRecordType(_:_:)
• AEStreamWriteAEDesc(_:_:)
• AEStreamWriteData(_:_:_:)
• AEStreamWriteDesc(_:_:_:_:)
• AEStreamWriteKeyDesc(_:_:_:_:_:)