#include <SFBAddrBook.h.hpp>

class SFBAddrBook : public SFBBase;

SFMTYPEDEFWRAPPER(SFBAddrBook)

[ public ]
SFBAddrRecSmp CreateRec(
    AEEAddrCat category   // このアドレスが属するカテゴリ。AEE_ADDR_CAT_NONE は“無関係”を意味する。
    AEEAddrField* items   // アドレスブックに入れる新しいアドレスレコード用のフィールドの配列。
    SInt32 itemCount      // フィールド配列 items 内のフィールドの数。
);

[ public ]
SFCError EnumCategoryInit(Void);

[ public ]
SFCError EnumFieldsInfoInit(
    AEEAddrCat category   
// フィールドのサポートを列挙すべきカテゴリを指定する。
// このパラメータを AEE_ADDR_CAT_NONE に設定した場合、
// この関数はすべてのカテゴリについてサポートされている全フィールドの列挙を初期化する。
        
);

[ public ]
Bool EnumNextCategory(
    AEEAddrCat* category   // カテゴリ情報が格納される。
);

[ public ]
Bool EnumNextFieldsInfo(
    AEEAddrFieldInfo* fieldInfo   // 入力時は、AEEAddrFieldInfo 構造体への有効なポインタを
指定する。戻り値がtrue の場合、このパラメータには、
このカテゴリでサポートされている次のフィールドタイプ
の情報が格納される。
);

[ public ]
SFBAddrRecSmp EnumNextRec(Void);

[ public ]
SFCError EnumRecInit(
    AEEAddrCat category      // 一致すべきカテゴリタイプ。これを AEE_ADDR_CAT_NONE に設定した場合は無視される。
    AEEAddrFieldID fieldId   
// 一致すべきAEEAddrFieldID。
// これをAEE_ADDRFIELD_NONE に設定した場合は無視される。
// ここでフィールドを指定する前に、アドレスブックがこのフィールドに基づく検索を許可しているかチェックする必要がある。
// これには、関数 IADDRBOOK_EnumFieldsInfoInit() と IADDRBOOK_EnumNextFieldsInfo() を使用する。
        
    VoidPtr data             // 非null の場合、一致すべき実際のデータを指定する。NULL の場合は無視される。
    UInt16 dataSize          // sizeof(pData) を指定する。
);

[ public ]
SFCError EnumRecInit(
    AEEAddrCat category      // 一致すべきカテゴリタイプ。これを AEE_ADDR_CAT_NONE に設定した場合は無視される。
    AEEAddrFieldID fieldId   
// 一致すべき AEEAddrFieldID。
// これを AEE_ADDRFIELD_NONE に設定した場合は無視される。
// ここでフィールドを指定する前に、アドレスブックがこのフィールドに基づく検索を許可しているかチェックする必要がある。
// これには、関数 IADDRBOOK_EnumFieldsInfoInit() と IADDRBOOK_EnumNextFieldsInfo() を使用する。
        
    SFXBufferPtr data        // 非null の場合、一致すべき実際のデータを指定する。NULL の場合は失敗する。
);

[ public ]
SFCError GetLastError(Void);

[ public ]
UInt16 GetNumRecs(Void);

[ public ]
UInt32 GetProperties(Void);

[ public ]
SFBAddrRecSmp GetRecByID(
    UInt16 id   // アドレスブックから取得するレコードのID
);

[ public, static ]
SFBAddrBookSmp NewInstance(
    AEECLSID clsid = AEECLSID_ADDRBOOK   
);

[ public ]
SFCError RemoveAllRecs(Void);

[ public ]
Void SetProperties(
    UInt32 properties   // プロパティ
);