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

<root>
  <func>


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



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



    <!-- 解説 -->
    <doc>
        <cmn>
            <p>データサーバに対してホストコンピュータからファイルを GET するように指示します。<br/>
            従って、本関数が正常終了したときは、ホストコンピュータからのファイルのGET が開始されたことを示します。<br/>
            ファイルを GET した結果については、<a href="data/cnc_dtsvftpstat.htm" target="_parent">cnc_dtsvftpstat</a> で取得して下さい。</p>

            <p>本関数が正常終了してから <a href="data/cnc_dtsvftpstat.htm" target="_parent">cnc_dtsvftpstat</a> により完了ステータスのEW_OK 、または EW_DTSRVR を取得するまで、CNC側でデータサーバ機能 (DNC運転を除く) を使用してはいけません。</p>

            <ul>

                <p><img src="data/cnc_dtsvftpget.gif"/></p>

                <p>※ "Req."は本関数によるファイルの GET の開始要求を表します。<br/>
                ※ "ret="は <a href="data/cnc_dtsvftpstat.htm" target="_parent">cnc_dtsvftpstat</a> を実行したときの完了ステータスを表します。</p>
            </ul>

            <p>また、使用禁止期間では以下の関数の完了ステータスが EW_BUSY になります。</p>
                <ul>
                    cnc_dtsvftpget<br/>
                    <a href="data/cnc_dtsvftpput.htm" target="_parent">cnc_dtsvftpput</a><br/>
                    <a href="data/cnc_dtsvdelete.htm" target="_parent">cnc_dtsvdelete</a><br/>
                    <a href="data/cnc_dtsvrdpgdir.htm" target="_parent">cnc_dtsvrdpgdir</a><br/>
                    <a href="data/cnc_dtsvrdset.htm" target="_parent">cnc_dtsvrdset</a><br/>
                    <a href="data/cnc_dtsvwrset.htm" target="_parent">cnc_dtsvwrset</a><br/>
                    <a href="data/cnc_dtsvchkdsk.htm" target="_parent">cnc_dtsvchkdsk</a><br/>
                    <a href="data/cnc_dtsvhdformat.htm" target="_parent">cnc_dtsvhdformat</a><br/>
                </ul>

            <p>従って、本関数を実行し正常終了した場合は、必ず <a href="data/cnc_dtsvftpstat.htm" target="_parent">cnc_dtsvftpstat</a> により完了ステータスの EW_OK 、または EW_DTSRVR を取得する必要があります。</p>
        </cmn>
    </doc>



    <!-- 引数 -->
    <argument>
        <hssb>
            <cmn>
                <item>
                    <name>FlibHndl</name>
                    <type>in</type>
                    <content>
                        <p>
                            ライブラリハンドルです。詳細は、「<a href="handle.htm" target="_parent">ライブラリハンドル</a>」を参照して下さい。
                        </p>
                    </content>
                </item>
                <item>
                    <name>net_file</name>
                    <type>in</type>
                    <content>
                        <p>ホストコンピュータ側のファイル名へのポインタ<br/>
                        ホストコンピュータ側のファイル名指定について以下に示します。</p>
                        <ul>
                            <li>ASCII文字列を使用して下さい。</li>
                            <li>ファイル名の最後は NULLで終了して下さい。</li>
                            <li>ファイル名の長さは NULLを含め最長256文字までです。</li>
                            <li>パスを含めた指定は行えません。(ディレクトリの指定は <a href="data/cnc_dtsvwrset.htm" target="_parent">cnc_dtsvwrset</a> で行って下さい)</li>
                            <li>小文字を使用できます。</li>
                            <li>ワイルドカード('*', '?')は使用できません。</li>
                        </ul>
                    </content>
                </item>
                <item>
                    <name>nc_file</name>
                    <type>in</type>
                    <content>
                        <p>データサーバ側のファイル名へのポインタ<br/>
                        データサーバ側のファイル名指定について以下に示します。</p>
                        <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>
                    </content>
                </item>
            </cmn>
        </hssb>
    </argument>



    <!-- 戻り値 -->
    <errcode>
        <item>
            <name>EW_BUSY</name>
            <content>
                ビジィ<br/>
                データサーバが処理中ですのでリトライして下さい。( <a href="data/cnc_dtsvftpstat.htm" target="_parent">cnc_dtsvftpstat</a> 呼び忘れの可能性もあります。)
            </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> 関数を実行して下さい。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>



    <reference>
        <item>
            <name>cnc_dtsvftpput</name>
            <file>Data/cnc_dtsvftpput.htm</file>
        </item>
    </reference>



  </func>
</root>
