#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 EnumRecInitEx(
    AEEAddrEnumRecInfo* enumRecInfo   // 検索条件を指定する AEEAddrEnumRecInfo 構造体へのポインタ
);

[ public ]
SFCError GetCategoryName(
    AEEAddrCat category   // テキスト名を探すカテゴリ
    WCharPtr name         // 入力時は、有効な Wchar バッファへのポインタか、または項目のサイズを問い合わせるには null を指定する。
                          // 戻り値に、指定されたカテゴリの null 終結 Wchar 文字列名がこのバッファに格納される。 
    SInt32Ptr size        // 入力時は、name バッファのサイズ（ バイト数 ）を指す。
                          // 戻り値は、リターン時は、name バッファに書き込まれたバイト数が size に格納される。
                          // name が null の場合は、このカテゴリ名を格納するために必要なバイト数が size に格納される。
);

[ public ]
SFCError GetCategoryName(
    AEEAddrFieldID field   // テキスト名を探すフィールド
    WCharPtr fieldName     // 入力時は、有効な Wchar バッファへのポインタか、または項目のサイズを問い合わせるには null を指定する。
                           // 戻り値に、指定されたフィールドのテキスト名がこのバッファに格納される。 
    SInt32Ptr size         // 入力時は、fieldName バッファのサイズ（ バイト数 ）を指す。
                           // 戻り値は、リターン時は、fieldName バッファに書き込まれたバイト数が size に格納される。
                           // fieldName が null の場合は、このカテゴリ名を格納するために必要なバイト数が size に格納される。
);

[ public ]
SFCError GetLastError(Void);

[ public ]
UInt16 GetNumRecs(Void);

[ public ]
UInt32 GetProperties(Void);

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

[ public, static ]
SFBAddrBookSmp NewInstance(
    SFCErrorPtr exception = null   // エラー値
);

[ public, static ]
SFBAddrBookSmp NewInstance(
    AEECLSID clsid = AEECLSID_ADDRBOOK   // クラス ID
    SFCErrorPtr exception = null         // エラー値
);

[ public ]
SFCError RemoveAllRecs(Void);

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