Technote 1111

Programmatic Mounting of AppleShare Volumes

目次 はじめに AppleShare Clients 3.0 − 3.6.5 AppleShare Client 3.7 要約

この TECHNOTE では、PBVolumeMount 呼び出しを使って AppleShare ボリュームをマウントする方法について説明します。

const   short   kASver_3_5      = 1;
const   short   kASver_3_6      = 2;
const   short   kASver_3_6_1    = 3;
const   short   kASver_3_6_2    = 4;
const   short   kASver_3_6_3    = 5;    // 3.6.3、3.6.4、3.6.5 を含む
const   short   kASver_3_7      = 6;    // 3.7.1 を含む
const   short   kASver_3_7_2    = 7;

short   ClientVersion(void)
{
    long    result;
    OSError theError = noErr;

    theError = Gestalt('afps',&result);
    if(!theError)
    {
        return(result & 0x0000ffff);
    }
    return 0;
}

struct AFPVolMountInfo {
    short       length;               /* ロケーションデータの長さ (このフィールドそのものを含む) */
    VolumeType  media;                /* メディアのタイプ */
    short       flags;                /* メッセージ、再接続がないかどうかを指定するビット */
    SInt8       nbpInterval;          /* NBP Interval パラメータ (IM2, p.322 を参照) */
    SInt8       nbpCount;             /* NBP Interval パラメータ (IM2, p.322 を参照) */
    short       uamType;              /* ユーザ認証方法 */
    short       zoneNameOffset;       /* 構造体の先頭から Zone Name までの short で正のオフセット */
    short       serverNameOffset;     /* Pascal 文字列 Server Name までのオフセット */
    short       volNameOffset;        /* Pascal 文字列 Volume Name までのオフセット */
    short       userNameOffset;       /* Pascal 文字列 User Name までのオフセット */
    short       userPasswordOffset;   /* Pascal 文字列 User Password までのオフセット */
    short       volPasswordOffset;    /* Pascal 文字列 Volume Password までのオフセット */
    char        AFPData[176];         /* 可変長データが続く場合 */
};
typedef struct AFPVolMountInfo AFPVolMountInfo;

• TCP/IP を介したボリュームのマウント
• AppleShare Client の“ログイン”および“ボリューム選択”ダイアログを使用するためのオプション
• PBVolumeMount でのカスタム UAM (User Authentication Module) のサポート

AFPXVolMountInfo を使った PBVolumeMount
次の定義を見れば、AFPXVolMountInfo 構造体が前述の AFPVolMountInfo 構造体の拡張であることがすぐにわかります。3 つの新しいフィールドと 2 つの新しいフラグビットを使用すると、デベロッパは TCP/IP や UAM をサポートするために必要な情報を指定できるようになります。もちろん 3.7 Client では、以前の AFPVolMountInfo 構造体もサポートされています。

次に、最新の Files.h に含まれる定義を示します。

/* AFPXVolMountInfo は新しい AFP ボリュームマウント情報レコードで、3.7 AppleShare Client を必要とする */

struct AFPXVolMountInfo {
    short         length;                 /* ロケーションデータの長さ (このフィールドそのものを含む) */
    VolumeType    media;                  /* メディアのタイプ */
    short         flags;                  /* メッセージ、再接続がないかどうかを指定するビット */
    SInt8         nbpInterval;            /* NBP Interval パラメータ (IM2, p.322 を参照) */
    SInt8         nbpCount;               /* NBP Interval パラメータ (IM2, p.322 を参照) */
    short         uamType;                /* ユーザ認証方法のタイプ */
    short         zoneNameOffset;         /* 構造体の先頭から Zone Name までの short で正のオフセット */
    short         serverNameOffset;       /* Pascal 文字列 Server Name までのオフセット */
    short         volNameOffset;          /* Pascal 文字列 Volume Name までのオフセット */
    short         userNameOffset;         /* Pascal 文字列 User Name までのオフセット */
    short         userPasswordOffset;     /* Pascal 文字列 User Password までのオフセット */
    short         volPasswordOffset;      /* Pascal 文字列 Volume Password までのオフセット */
    short         extendedFlags;          /* 拡張されたフラグワード */
    short         uamNameOffset;          /* Pascal 文字列 UAM Name までのオフセット */
    short         alternateAddressOffset; /* タグフォーマットの Alternate Addresses までのオフセット */
    char          AFPData[176];           /* 可変長データが続く場合 */
};
typedef struct AFPXVolMountInfo AFPXVolMountInfo;

typedef AFPXVolMountInfo *              AFPXVolMountInfoPtr;

/* ボリュームマウントフラグ */

enum {
    volMountNoLoginMsgFlagBit   = 0,         /* VolumeMount への入力: セットされている場合、ファイルシステムは */
    volMountNoLoginMsgFlagMask  = 0x0001,    /* ログインメッセージダイアログを表示しない */
    volMountExtendedFlagsBit    = 7,         /* VolumeMount への入力: セットされている場合、マウント情報は */
    volMountExtendedFlagsMask   = 0x0080,    /* 3.7 AppleShare Client に対応する AFPXVolMountInfo レコード */
    volMountInteractBit         = 15,        /* VolumeMount への入力: セットされている場合、ファイルシステムが */
    volMountInteractMask        = 0x8000,    /* ボリュームをマウントするためにユーザの操作を実行することが許可される */
    volMountChangedBit          = 14,        /* VoumeMount からの出力: セットされている場合、ボリュームはマウントされていたが、 */
    volMountChangedMask         = 0x4000,    /* ボリュームのマウント情報レコードは更新される必要がある */
    volMountFSReservedMask      = 0x00FF,    /* ビット 0-7 はそれぞれのファイルシステムが独自に使用するために定義されている */
    volMountSysReservedMask     = 0xFF00     /* ビット 8-15は Apple システムが使用するために予約されている */
};

enum {
    kAFPExtendedFlagsAlternateAddressMask = 1  /* AFPXVolMountInfo.extendedFlags のビットで、alternateAddressOffset が使用されていることを意味する */
};

enum {    /* AFPTagData.fType フィールドで使用する定数 */
    kAFPTagTypeIP        = 0x01,
    kAFPTagTypeIPPort    = 0x02,
    kAFPTagTypeDDP       = 0x03    /* 現在は未使用 */
};



enum {    /* AFPTagData.fLength フィールドで使用する定数 */
    kAFPTagLengthIP        = 0x06,
    kAFPTagLengthIPPort    = 0x08,
    kAFPTagLengthDDP       = 0x06
};

struct AFPTagData {
    UInt8    fLength;     /* fLength フィールドを含めたこのデータタグの長さ */
    UInt8    fType;
    UInt8    fData[1];    /* 可変長データ */
};
typedef struct AFPTagData AFPTagData;

struct AFPAlternateAddress {
    UInt8    fAddressCount;
    UInt8    fAddressList[1];    /* AFPTagData の実際に可変長パックされたセット */
};
typedef struct AFPAlternateAddress AFPAlternateAddress;

更新日: 1997 年 10 月 31 日