リスト 1. AEGetDescDataSize と AEGetDescData を使用して AEDesc レコードに保存されているデータのコピーを取得

Ptr theData;
Size theLength;
AEDesc theDesc;
OSStatus err;

    ....

    /* ディスクリプタレコードに保存されている
    データの長さを調べる */
theLength = AEGetDescDataSize(&theDesc);

    /* データのコピーを保持するためのバッファを割り当てる*/
theData = malloc(theLength);
if (theData != NULL) {

        /* データをバッファにコピーする */
    err = AEGetDescData(theDesc, theData, theLength);
    if ( err == noErr) {

        /* 取得したデータで何らかの操作を実行する*/

        ....

重要：
AEGetDescData ルーチン、AEGetDescDataSize ルーチンおよび、 AEReplaceDescData ルーチンは、単純な値を保存するディスクリプタにのみ使用できます。AppleEvent レコード、AERecord レコード、 および AEDescList レコードのような複合型のディスクリプタレコードには使えません。複合型のディスクリプタレコードにこれらのルーチンを使おうとすれば、予期しない結果が生じ、アプリケーションがクラッシュする場合があります。

リスト 2　AEDesc 構造体の宣言

typedef AEDataStorageType *AEDataStorage;

struct AEDesc {
    DescType       descriptorType; /* データ型フィールド */
    AEDataStorage  dataHandle;     /* データフィールド */
};

警告：
AEDesc 構造体の dataHandle フィールドに保存されている値を使っている、あるいは dataHandle フィールドに Carbon Memory Manager Handle が含まれていることを仮定するコードは、現在サポートされておらず、また Mac OS X における Apple Event Manager の今後の実装では機能しないかもしれません。

リスト 3 AEDesc レコードの dataHandle フィールドに保存されている値を使わないコードの構築例

    AEDesc theDesc;
    char* p = "Hello World";

        /* ディスクリプタを作成する */
    err = AECreateDesc(typeChar, p, strlen(p), &theDesc);
    if (err == noErr) {

        /* 作成したディスクリプタを使って何らかの操作を実行する */

            /* ディスクリプタを削除する */
        AEDisposeDesc(&theDesc);
    }

リスト 4　AEDesc レコードの dataHandle フィールドについて安全な仮定をしたコードの例

AEDesc d = { typeNull, NULL };  // 新しい空のディスクリプタを初期化する

if (d.dataHandle != NULL)  // ディスクリプタが空でないかどうかを調べる負担の軽いチェック