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

<root>
  <func>


    <title>ds_mgethostfile</title>



    <declare>
      <vc>
        <include>#include "fwlib32.h"</include>
        <prottype>FWLIBAPI short WINAPI ds_mgethostfile(unsigned short FlibHndl,char *net_file);</prottype>
      </vc>
    </declare>



    <doc>
        <cmn>
            <p>
                The files of the host computer are transferred to the hard disk of the
                DATA SERVER according to the "mget" command of the FTP.
                The some files can be transferred simultaneously by specifying
                wild-card("*","?").
                In this function, the control returns to the application without only
                requesting the transfer of the file according to the "mput" command of
                the FTP to the DATA SERVER, and waiting for the end of the processing.
                The final result can be acquired by <a href="Data/ds_rdresult.htm" target="_parent">ds_rdresult</a> function.
             </p>
             <p>
                When this function ends normally, the process of DATA SERVER is
                occupied by the requested work.  When the <a href="Data/ds_rdresult.htm" target="_parent">ds_rdresult</a>
                is normal end or it returns the values other than EW_BUSY, this occupation are released.
             </p>
                When the process of requested work by this function is executing, the
                processing can be discontinued by <a href="Data/ds_cancel.htm" target="_parent">ds_cancel</a>.  
                When processing is discontinued, the occupation of the DATA SERVER is released.
        </cmn>
    </doc>



    <argument>
        <hssb>
            <cmn>
                <item>
                    <name>FlibHndl</name>
                    <type>in</type>
                    <content>
                        <p>
                            Specify the library handle. See "<a href="handle.htm" target="_parent">Library handle</a>" for details.
                        </p>
                    </content>
                </item>
                <item>
                    <name>net_file</name>
                    <type>in</type>
                    <content>
                        <p>
                            Specify the pointer to the string where the file name of the
                            transfer source(file name of the host computer) is stored.
                            Specify the Ascii string less than 256 characters which
                            included NULL.
                        </p>
                    </content>
                </item>
            </cmn>
        </hssb>
    </argument>



    <errcode>
        <item>
            <name>EW_NOOPT</name>
            <content>No option</content>
        </item>
        <item>
            <name>EW_REJECT</name>
            <content>CNC execution rejection<br/>
                     The DATA SERVER is doing another processing.
            </content>
        </item>
    </errcode>



    <option>
        <hssb>
            <p> 
                The DATA SERVER function and the extended driver/library function are necessary.
            </p>
        </hssb>
    </option>



    <parameter>
    </parameter>



    <mode>
    </mode>



    <support>
        <m>
            <fs0ia>X</fs0ia>
            <fs0ib>X</fs0ib>
            <fs15>X</fs15>
            <fs15i>X</fs15i>
            <fs16>X</fs16>
            <fs18>X</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>
            <fs0ia>X</fs0ia>
            <fs0ib>X</fs0ib>
            <fs15>X</fs15>
            <fs15i>X</fs15i>
            <fs16>X</fs16>
            <fs18>X</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>
            <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>
            <fs16i>X</fs16i>
            <fs18i>X</fs18i>
        </p>
        <l>
            <fs16i>X</fs16i>
            <fs18i>X</fs18i>
        </l>
        <w>
            <fs16i>X</fs16i>
            <fs18i>X</fs18i>
        </w>
        <pw>
            <d>X</d>
            <h>X</h>
        </pw>
    </support>



    <reference>
    </reference>



    <example>
    </example>



  </func>
</root>
