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

<root>
  <func>


    <title>cnc_dslistget_req</title>



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



    <doc>
        <cmn>
            According to the list file which exists in the connection host of DATA SERVER function, the file transfer of two or more files is continuously carried out to an ATA card.<br/>

            When this function carries out a normal end, it is shown that List-GET of the file from a host computer was started.<br/>
            Please take out with <a href="Data/cnc_dsftpstat.htm" target="_parent">cnc_dsftpstat()</a> about the result which List-GET the file.<br/>

            Don't use DATA SERVER function (expect for DNC operetion) by the CNC side after this function carries out a normal end until it takes out EW_OK of completion status, or EW_DTSRVR with <a href="Data/cnc_dsftpstat.htm" target="_parent">cnc_dsftpstat()</a>.<br/><br/>

            <img src="Data/cnc_dslistget_req.gif"></img>

            <dl>
            <table border="0" class = "dd">
            <tr> <td width = "40"> </td><td>*</td><td>"Req." is declare start demand the file List-GET.</td> </tr>
            <tr> <td width = "40"> </td><td> </td><td>"ret=" is declare the completion status when perfoming <a href="Data/cnc_dsftpstat.htm" target="_parent">cnc_dsftpstat()</a> function.</td> </tr>
            </table></dl>

            Therefore, it is necessary to get either EW_OK or EW_DTSRVR as the completion status by <a href="Data/cnc_dsftpstat.htm" target="_parent">cnc_dsftpstat()</a> when this function was executed successfully. <br/>
        </cmn>
    </doc>



    <argument>
        <common>
            <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>file</name>
                    <type>in</type>
                    <content>
                        A file name to carry out a file transfer from the ATA card of DATA SERVER function is specfied.<br/>
                <ul><dl>
                        <table border="0">
                        <tr> <td> <li>Use ASCII code.</li> </td> </tr>
                        <tr> <td> <li>The last character of the file name must be 'NULL'.</li> </td> </tr>
                        <tr> <td> <li>Maximum of 33 characters of the the file is including NULL.</li> </td> </tr>
                        <tr> <td> <li>It is impossible to specify the path.</li> </td> </tr>
                        <tr> <td> <li>The lowercase can be used.</li> </td> </tr>
                        </table></dl></ul>
                    </content>
                </item>
            </cmn>
        </common>
    </argument>



    <errcode>
        <item>
            <name>EW_NOOPT</name>
            <content>No option<br/>
                In order to get more information for this err_no return value, execute <a href="Misc/cnc_getdtailerr.htm" target="_parent">cnc_getdtailerr()</a> function.<br/>
                The following details status will be set onto the member, err_no of ODBERR structure.<br/>
                <table class="dd">
                    <tr> <td>22</td><td>:</td><td>The option board is nothing</td> </tr>
                    <tr> <td>24</td><td>:</td><td>The DATA SERVER function is nothing. </td> </tr>
                    <tr> <td>26</td><td>:</td><td>The ATA Card is nothing. </td> </tr>
                </table>
            </content>
        </item>
        <item>
            <name>EW_BUSY</name>
            <content>
                Busy<br/>
                - Try again because DATA SERVER is processing. <br/>
            </content>
        </item>
    </errcode>



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



    <parameter></parameter>
    <is_parameter></is_parameter>



    <mode></mode>
    <is_mode></is_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>X</fs16ia>
            <fs18ia>X</fs18ia>
            <fs21ia>X</fs21ia>
            <fs16ib>X</fs16ib>
            <fs18ib>X</fs18ib>
            <fs21ib>X</fs21ib>
            <fs30i>H</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>X</fs16ia>
            <fs18ia>X</fs18ia>
            <fs21ia>X</fs21ia>
            <fs16ib>X</fs16ib>
            <fs18ib>X</fs18ib>
            <fs21ib>X</fs21ib>
            <fs30i>H</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>
        <!-- 300is -->
        <is>
            <m>
                <fs30is>O</fs30is>
            </m>
            <t>
                <fs30is>O</fs30is>
            </t>
        </is>
    </support>



    <reference>
        <item>
            <name>cnc_dslistput_req</name>
            <file>Data/cnc_dslistput_req.htm</file>
        </item>
        <item>
            <name>cnc_dslistdel_req</name>
            <file>Data/cnc_dslistdel_req.htm</file>
        </item>
    </reference>



    <example>
    </example>



  </func>
</root>
