<?xml version="1.0" encoding="Shift_JIS"?>
<?xml-stylesheet type="text/xsl" href="../Fmethod_xsl/fmethod_he_c.xsl"?>

<root>
  <func>


    <!-- 関数名 -->
    <title>cnc_dtsvrdpgdir</title>



    <!-- 関数宣言 -->
    <declare>
      <!-- Visual C++の宣言 -->
      <vc>
        <include>#include "fwlib32.h"</include>
        <prottype>FWLIBAPI short WINAPI cnc_dtsvrdpgdir(unsigned short FlibHndl, char *nc_file,short number,ODBDSDIR *dsdir);</prottype>
      </vc>
    </declare>



    <!-- 解説 -->
    <doc>
        <cmn>
            <p>データサーバ内のディレトクリ情報を読み出します。</p>

            <p><a href="data/cnc_dtsvftpput.htm" target="_parent">cnc_dtsvftpput</a>、及び <a href="data/cnc_dtsvftpget.htm" target="_parent">cnc_dtsvftpget</a> の実行中(両関数実行後、<a href="data/cnc_dtsvftpstat.htm" target="_parent">cnc_dtsvftpstat</a> により完了ステータスを取得するまでの間)に本関数を実行すると、完了ステータスがEW_BUSY となります。</p>

        </cmn>
    </doc>



    <!-- 引数 -->
    <argument>
        <hssb>
            <vc>
                <item>
                    <name>FlibHndl</name>
                    <type>in</type>
                    <content>
                        <p>
                            ライブラリハンドルです。詳細は、「<a href="handle.htm" target="_parent">ライブラリハンドル</a>」を参照して下さい。
                        </p>
                    </content>
                </item>
                <item>
                    <name>nc_file</name>
                    <type>in</type>
                    <content>
                        <p>リードを行う先頭のファイル名へのポインタ<br/>
                        NULL(先頭の文字が NULL)が設定された場合は、先頭ファイルが指定されたものとします。<br/>
                        指定されたファイルが存在しない場合は、ディレクトリ上にあるアルファベット順で次のファイルが指定されたものとします。ただし、最後のファイルより後のファイルが指定された場合は、最後のファイルとなります。</p>

                        <table>
                            <colgroup valign="top">
                            <colgroup valign="top">
                            <tr>
                                <td>〈例〉</td>
                                <td>データサーバ側に"O0001"〜"O0010"と"O0016"〜"O0020"の合計15個のファイルが登録されている場合を想定します。このとき次のように設定すると、"O0016"から 3個分のファイル情報が取得されます。</td>
                            </tr>
                            <tr>
                                <td></td>
                                <td><p class="dd">nc_file = "O0013", number = 3</p></td>
                            </tr>
                            <tr>
                                <td></td>
                                <td>
                                    データサーバ側のファイル名指定について
                                    <ul>
                                        <li>ASCII文字列を使用して下さい。</li>
                                        <li>ファイル名の最後は NULLで終了して下さい。</li>
                                        <li>パスを含めた指定は行えません。</li>
                                            (データサーバのディレクトリ("\PROG":データサーバボード(10BASE-5)の場合，"\NCDATA":データサーバボード(10BASE-T)の場合)にファイルが作成されます。)
                                        <li>ワイルドカード('*', '?')は使用できません。</li>
                                        <li>MS-DOS形式にて指定して下さい。</li>
                                            (ファイル名 8文字+'.'+拡張子 3文字+NULLの13文字以内)
                                        <p class="dd">例〉      "XXXXXXXX.XXX" + NULL</p>
                                            ただし、現在はO番号をファイル名として管理しています。
                                        <p class="dd">例〉      "O0001" + NULL</p>
                                    </ul>
                                </td>
                            </tr>
                            </colgroup>
                            </colgroup>
                        </table>
                    </content>
                </item>
                <item>
                    <name>number</name>
                    <type>in</type>
                    <content>
                        <p>リードを行うディレクトリの数を指定します。</p>
                        <p class="dd">有効範囲 : 1 ≦ number ≦ 32</p>
                    </content>
                </item>
                <item>
                    <name>dsdir</name>
                    <type>out</type>
                    <content>
                        <p>ディレトクリ情報を返すODBDSDIR構造体へのポインタです。<br/>
                            ODBDSDIR構造体は次の通りです。</p>
<pre>
typedef struct odbdsdir {
    long    file_num ;  /* ハードディスク内のファイルの数 */
    long    remainder ; /* ハードディスクの残り容量 */
    short   data_num ;  /* ディレクトリの個数 */
    struct {
        char    file_name[16] ; /* ファイル名 */
        char    comment[64] ;   /* コメント */
        long    size ;          /* ファイルサイズ */
        char    date[16] ;      /* 更新日付 */
    } data[32] ;
} ODBDSDIR ;
</pre>

                        <dl>
                            <dt>file_num</dt>
                            <dd>データサーバのハードディスク内に登録されているファイルの数</dd>
                            <br/>
                            <dt>remainder</dt>
                            <dd>データサーバのハードディスクの残り容量 (バイト数)</dd>
                            <br/>
                            <dt>data_num</dt>
                            <dd>取得したディレクトリの個数</dd>
                            <br/>
                            <dt>file_name</dt>
                            <dd>ファイル名</dd>
                            <br/>
                            <dt>comment</dt>
                            <dd>
                                コメント<br/>
                                ファイル名(プログラム番号)の直後のコメントがアスキー文字列で格納されます。文字列の最後はNULLで終わり、NULLを含めて最大６４文字が格納されます。ただし、LFは含まれません。
                            </dd>
                            <br/>
                            <dt>size</dt>
                            <dd>ファイルサイズ(バイト数)</dd>
                            <br/>
                            <dt>date</dt>
                            <dd>
                                ファイルの更新日付<br/>
                                次の形式のアスキー文字列で格納されます。文字列の最後は NULLで終了します。<br/><br/>
                                <table>
                                    <colgroup valign="top">
                                    <colgroup valign="top">
                                    <tr>
                                        <td>date = </td>
                                        <td>"11-11-11 11:11" + NULL</td>
                                    </tr>
                                    <tr>
                                        <td></td>
                                        <td>( 年 月 日 時 分 )</td>
                                    </tr>
                                    </colgroup>
                                    </colgroup>
                                </table>
                            </dd>
                            <br/>
                        </dl>
                    </content>
                </item>
            </vc>
        </hssb>
    </argument>



    <!-- 戻り値 -->
    <errcode>
        <item>
            <name>EW_BUSY</name>
            <content>
                ビジィ<br/>
                データサーバが処理中ですのでリトライして下さい。<br/>
                ( <a href="data/cnc_dtsvftpstat.htm" target="_parent">cnc_dtsvftpstat</a> の未実行を含みます。)
            </content>
        </item>
        <item>
            <name>EW_NUMBER</name>
            <content>
                データ番号の誤り<br/>
                リードを行うディレクトリの数(number)が不正です。
            </content>
        </item>
        <item>
            <name>EW_NOOPT</name>
            <content>オプションなし<br/>データサーバボード(ハード)、拡張ドライバ/ライブラリ機能が必要です。</content>
        </item>
        <item>
            <name>EW_DTSRVR</name>
            <content>
                データサーバのエラー<br/>
                この戻り値に対して、より詳細な情報を得るには <a href="Misc/cnc_getdtailerr.htm" target="_parent">cnc_getdtailerr</a> 関数を実行して下さい。<br/>
                ODBERR構造体のメンバ err_no に下記詳細ステータスがセットされます。
                <table class="dd">
                    <tr><td>1 〜 498</td><td>:</td><td>データサーバエラー</td></tr>
                    <tr><td>     499</td><td>:</td><td> データサーバシステムエラー</td></tr>
                </table>
            </content>
        </item>
        <add></add>
    </errcode>



    <!-- CNCオプション -->
    <option>
        <hssb>拡張ドライバ/ライブラリ機能が必要です。</hssb>
    </option>



    <!-- CNCパラメータ -->
    <parameter>
    </parameter>



    <!-- CNCモード -->
    <mode>
    </mode>



    <!-- 対応機種 -->
    <support>
        <!-- M（ミリング） -->
        <m>
            <fs0ia>X</fs0ia>
            <fs0ib>H</fs0ib>
            <fs15>H</fs15>
            <fs15i>X</fs15i>
            <fs16>H</fs16>
            <fs18>H</fs18>
            <fs21>X</fs21>
            <fs16ia>H</fs16ia>
            <fs18ia>H</fs18ia>
            <fs21ia>H</fs21ia>
            <fs16ib>H</fs16ib>
            <fs18ib>H</fs18ib>
            <fs21ib>H</fs21ib>
            <fs30i>X</fs30i>
        </m>
        <!-- T（旋盤） -->
        <t>
            <fs0ia>X</fs0ia>
            <fs0ib>H</fs0ib>
            <fs15>H</fs15>
            <fs15i>X</fs15i>
            <fs16>H</fs16>
            <fs18>H</fs18>
            <fs21>X</fs21>
            <fs16ia>H</fs16ia>
            <fs18ia>H</fs18ia>
            <fs21ia>H</fs21ia>
            <fs16ib>H</fs16ib>
            <fs18ib>H</fs18ib>
            <fs21ib>H</fs21ib>
            <fs30i>X</fs30i>
        </t>
        <!-- LC（ローダ制御） -->
        <lc>
            <fs0ia>X</fs0ia>
            <fs0ib>X</fs0ib>
            <fs15>X</fs15>
            <fs15i>X</fs15i>
            <fs16>X</fs16>
            <fs18>X</fs18>
            <fs21>X</fs21>
            <fs16ia>X</fs16ia>
            <fs18ia>X</fs18ia>
            <fs21ia>X</fs21ia>
            <fs16ib>X</fs16ib>
            <fs18ib>X</fs18ib>
            <fs21ib>X</fs21ib>
            <fs30i>X</fs30i>
        </lc>
        <!-- P（パンチプレス） -->
        <p>
            <fs16i>H</fs16i>
            <fs18i>H</fs18i>
        </p>
        <!-- L（レーザ） -->
        <l>
            <fs16i>H</fs16i>
            <fs18i>X</fs18i>
        </l>
        <!-- W（ワイヤカット） -->
        <w>
            <fs16i>X</fs16i>
            <fs18i>X</fs18i>
        </w>
        <!-- PM（パワーメート） -->
        <pw>
            <d>X</d>
            <h>X</h>
        </pw>
    </support>



  </func>
</root>
