237 lines
16 KiB
HTML
237 lines
16 KiB
HTML
<HTML>
|
|
<HEAD>
|
|
<TITLE>Int 21/AH=4Eh
|
|
</TITLE>
|
|
<META NAME="Description" CONTENT="
|
|
Int 21/AH=4Eh - DOS 2+ - FINDFIRST - FIND FIRST MATCHING FILE -
|
|
AH = 4Eh
|
|
AL = special flag for use by APPEND (refer to note below)
|
|
CX = file attribute mask (see #01420 at AX=4301h) (bits 0 and 5 ignored)
|
|
0088h (Novell DOS 7) find first deleted file
|
|
DS:DX - ASCIZ file specification (may include path and wildcards)
|
|
Return: CF clear if successful
|
|
Disk Transfer Area filled with FindFirst data block (see #01626)
|
|
CF set on error
|
|
AX = error code (02h,03h,12h) (see #01680 at AH=59h/BX=0000h)
|
|
Notes: for search attributes other than 08h, all files with at MOST the
|
|
">
|
|
<META NAME="robots" CONTENT="none">
|
|
</HEAD>
|
|
<BODY BGCOLOR="#FFD0A0">
|
|
<center>
|
|
<h2>Int 21/AH=4Eh
|
|
</h2>
|
|
</center><p>
|
|
<table border=1 cellpadding=3 cellspacing=1>
|
|
<td>
|
|
<a href="rb-2976.htm" tppabs="http://www.ctyme.com/intr/rb-2976.htm">
|
|
<img src="lup.gif" tppabs="http://graphics.ctyme.com/gif/lup.gif" border=0 alt=Prev></a>
|
|
<a href="rb-2978.htm" tppabs="http://www.ctyme.com/intr/rb-2978.htm">
|
|
<img src="ldown.gif" tppabs="http://graphics.ctyme.com/gif/ldown.gif" border=0 alt=Next></a>
|
|
<a href="javascript:if(confirm('http://www.ctyme.com/rbrown.htm \n\nThis file was not retrieved by Teleport Pro, because it is addressed on a domain or path outside the boundaries set for its Starting Address. \n\nDo you want to open it from the server?'))window.location='http://www.ctyme.com/rbrown.htm'" tppabs="http://www.ctyme.com/rbrown.htm">
|
|
<img src="lhome.gif" tppabs="http://graphics.ctyme.com/gif/lhome.gif" border=0 alt=Ralf Brown Page></a>
|
|
<td><a href="int.htm" tppabs="http://www.ctyme.com/intr/int.htm">Interrups</a></td>
|
|
<td><a href="cat.htm" tppabs="http://www.ctyme.com/intr/cat.htm">Categories</a></td>
|
|
<td><a href="alpha.htm" tppabs="http://www.ctyme.com/intr/alpha.htm">Contents</a></td>
|
|
</td></table><p>
|
|
<p><img src="rbline.gif" tppabs="http://graphics.ctyme.com/gif/rbline.gif" width="100%" alt="------"><p>
|
|
<h3><font color=#C00040>DOS 2+ - FINDFIRST - FIND FIRST MATCHING FILE</font></h3>
|
|
<PRE>
|
|
AH = 4Eh
|
|
AL = special flag for use by APPEND (refer to note below)
|
|
CX = file attribute mask <a href="javascript:if(confirm('http://www.ctyme.com/intr/rb-0000.htm \n\nThis file was not retrieved by Teleport Pro, because it was unavailable, or its retrieval was aborted, or the project was stopped too soon. \n\nDo you want to open it from the server?'))window.location='http://www.ctyme.com/intr/rb-0000.htm#Table0'" tppabs="http://www.ctyme.com/intr/rb-0000.htm#Table0"></a>(see #01420 at AX=4301h) (bits 0 and 5 ignored)
|
|
0088h (Novell DOS 7) find first deleted file
|
|
DS:DX -> ASCIZ file specification (may include path and wildcards)<br>
|
|
<p><b>Return:</b><br>CF clear if successful
|
|
Disk Transfer Area filled with FindFirst data block <a href="rb-2977.htm#Table1626" tppabs="http://www.ctyme.com/intr/rb-2977.htm#Table1626">(see #01626)</a>
|
|
CF set on error
|
|
AX = error code (02h,03h,12h) <a href="javascript:if(confirm('http://www.ctyme.com/intr/rb-0000.htm \n\nThis file was not retrieved by Teleport Pro, because it was unavailable, or its retrieval was aborted, or the project was stopped too soon. \n\nDo you want to open it from the server?'))window.location='http://www.ctyme.com/intr/rb-0000.htm#Table0'" tppabs="http://www.ctyme.com/intr/rb-0000.htm#Table0"></a>(see #01680 at AH=59h/BX=0000h)
|
|
</PRE>
|
|
<p><b>Notes:</b>
|
|
For search attributes other than 08h, all files with at MOST the
|
|
specified combination of hidden, system, and directory attributes
|
|
will be returned. Under DOS 2.x, searching for attribute 08h
|
|
(volume label) will also return normal files, while under DOS 3.0+
|
|
only the volume label (if any) will be returned..
|
|
This call also returns successfully if given the name of a character
|
|
device without wildcards. DOS 2.x returns attribute 00h, size 0,
|
|
and the current date and time. DOS 3.0+ returns attribute 40h and
|
|
the current date and time..
|
|
Immediately after an INT 2F/AX=B711h (APPEND return found name), the
|
|
name at DS:DX will be overwritten; if AL=00h on entry, the actual
|
|
found pathname will be stored, otherwise, the actual found path
|
|
will be prepended to the original filespec without a path..
|
|
Under LANtastic, this call may be used to obtain a list of a server's
|
|
shared resources by searching for "\\SERVER\*.*"; a list of printer
|
|
resources may be obtained by searching for "\\SERVER\@*.*".
|
|
Under the FlashTek X-32 DOS extender, the filespec pointer is in DS:EDX
|
|
<p><b>BUGS:</b>
|
|
Under DOS 3.x and 4.x, the second and subsequent calls to this function
|
|
with a character device name (no wildcards) and search attributes
|
|
which include the volume-label bit (08h) will fail unless there is
|
|
an intervening DOS call which implicitly or explicity performs a
|
|
directory search without the volume-label bit. Such implicit
|
|
searches are performed by CREATE (AH=3Ch), OPEN (AH=3Dh), UNLINK
|
|
(AH=41h), and RENAME (AH=56h).
|
|
DR DOS 3.41 and 5.0 return the Directory attribute for the volume label
|
|
<p><b>See Also:</b>
|
|
<a href="rb-2576.htm" tppabs="http://www.ctyme.com/intr/rb-2576.htm">AH=11h</a> - <a href="rb-2979.htm" tppabs="http://www.ctyme.com/intr/rb-2979.htm">AH=4Fh</a> - <a href="rb-2803.htm" tppabs="http://www.ctyme.com/intr/rb-2803.htm">AX=4301h</a> - <a href="rb-3203.htm" tppabs="http://www.ctyme.com/intr/rb-3203.htm">AX=714Eh</a> - <a
|
|
<p><b>See Also:</b>
|
|
<a href="rb-4332.htm" tppabs="http://www.ctyme.com/intr/rb-4332.htm">INT 2F/AX=111Bh</a> - <a href="rb-5243.htm" tppabs="http://www.ctyme.com/intr/rb-5243.htm">INT 2F/AX=B711h</a>
|
|
<PRE>
|
|
<p>
|
|
Format of FindFirst data block:
|
|
<a name=table1626></a>
|
|
Offset Size Description (Table 01626)
|
|
---PC-DOS 3.10, PC-DOS 4.01, MS-DOS 3.2/3.3/5.0---
|
|
00h BYTE drive letter (bits 0-6), remote if bit 7 set
|
|
01h 11 BYTEs search template
|
|
0Ch BYTE search attributes
|
|
---DOS 2.x (and some DOS 3.x???)---
|
|
00h BYTE search attributes
|
|
01h BYTE drive letter
|
|
02h 11 BYTEs search template
|
|
---WILDUNIX.COM---
|
|
00h 12 BYTEs 15-character wildcard search pattern and drive letter (packed)
|
|
0Ch BYTE search attributes
|
|
---DOS 2.x and most 3.x---
|
|
0Dh WORD entry count within directory
|
|
0Fh DWORD pointer to DTA???
|
|
13h WORD cluster number of start of parent directory
|
|
---PC-DOS 4.01, MS-DOS 3.2/3.3/5.0---
|
|
0Dh WORD entry count within directory
|
|
0Fh WORD cluster number of start of parent directory
|
|
11h 4 BYTEs reserved
|
|
---OS/2 MVDM---
|
|
00h WORD "OS2_BMP_handle"
|
|
02h WORD "OS2_LastEnt"
|
|
04h DWORD "OS2_Checksum"
|
|
08h BYTE "OS2_usi_flag"
|
|
09h DWORD used by DOS emulator for second pass for volume-label searches
|
|
0Dh WORD (ret) "DOS_LastEnt" entry count within directory
|
|
0Fh BYTE OS/2 Processed-FindFirst flag
|
|
00h FindFirst processed by DOS
|
|
42h FindFirst processed by OS/2
|
|
10h 5 BYTEs reserved for future use
|
|
---all versions, documented fields---
|
|
15h BYTE attribute of file found
|
|
16h WORD file time <a href="javascript:if(confirm('http://www.ctyme.com/intr/rb-0000.htm \n\nThis file was not retrieved by Teleport Pro, because it was unavailable, or its retrieval was aborted, or the project was stopped too soon. \n\nDo you want to open it from the server?'))window.location='http://www.ctyme.com/intr/rb-0000.htm#Table0'" tppabs="http://www.ctyme.com/intr/rb-0000.htm#Table0"></a>(see #01665 at AX=5700h)
|
|
18h WORD file date <a href="javascript:if(confirm('http://www.ctyme.com/intr/rb-0000.htm \n\nThis file was not retrieved by Teleport Pro, because it was unavailable, or its retrieval was aborted, or the project was stopped too soon. \n\nDo you want to open it from the server?'))window.location='http://www.ctyme.com/intr/rb-0000.htm#Table0'" tppabs="http://www.ctyme.com/intr/rb-0000.htm#Table0"></a>(see #01666 at AX=5700h)
|
|
1Ah DWORD file size
|
|
1Eh 13 BYTEs ASCIZ filename+extension
|
|
</PRE>
|
|
<p>
|
|
<b>Category: <a href="cat-010.htm" tppabs="http://www.ctyme.com/intr/cat-010.htm">
|
|
DOS Kernel</a>
|
|
- <a href="int-21.htm" tppabs="http://www.ctyme.com/intr/int-21.htm">
|
|
Int 21h</a>
|
|
- <a href="alpha-d.htm" tppabs="http://www.ctyme.com/intr/alpha-d.htm">
|
|
D</a>
|
|
</b><p><p><img src="rbline.gif" tppabs="http://graphics.ctyme.com/gif/rbline.gif" width="100%" alt="------"><p>
|
|
<table border=1 cellpadding=3 cellspacing=1>
|
|
<td>
|
|
<a href="rb-2976.htm" tppabs="http://www.ctyme.com/intr/rb-2976.htm">
|
|
<img src="lup.gif" tppabs="http://graphics.ctyme.com/gif/lup.gif" border=0 alt=Prev></a>
|
|
<a href="rb-2978.htm" tppabs="http://www.ctyme.com/intr/rb-2978.htm">
|
|
<img src="ldown.gif" tppabs="http://graphics.ctyme.com/gif/ldown.gif" border=0 alt=Next></a>
|
|
<a href="javascript:if(confirm('http://www.ctyme.com/rbrown.htm \n\nThis file was not retrieved by Teleport Pro, because it is addressed on a domain or path outside the boundaries set for its Starting Address. \n\nDo you want to open it from the server?'))window.location='http://www.ctyme.com/rbrown.htm'" tppabs="http://www.ctyme.com/rbrown.htm">
|
|
<img src="lhome.gif" tppabs="http://graphics.ctyme.com/gif/lhome.gif" border=0 alt=Ralf Brown Page></a>
|
|
<td><a href="int.htm" tppabs="http://www.ctyme.com/intr/int.htm">Interrups</a></td>
|
|
<td><a href="cat.htm" tppabs="http://www.ctyme.com/intr/cat.htm">Categories</a></td>
|
|
<td><a href="alpha.htm" tppabs="http://www.ctyme.com/intr/alpha.htm">Contents</a></td>
|
|
</td></table><p>
|
|
|
|
<!-- Bottom Link Start -->
|
|
|
|
<center>
|
|
|
|
<p><table border=1 bgcolor="#ffff99"><tr><td>
|
|
<table border=0 height=80>
|
|
<tr align=center><td width="65">
|
|
|
|
<a href="javascript:if(confirm('http://www.ctyme.com/sponsor.htm \n\nThis file was not retrieved by Teleport Pro, because it is addressed on a domain or path outside the boundaries set for its Starting Address. \n\nDo you want to open it from the server?'))window.location='http://www.ctyme.com/sponsor.htm'" tppabs="http://www.ctyme.com/sponsor.htm">
|
|
<img src="tip.gif" tppabs="http://graphics.ctyme.com/gif/tip.gif" ALT="Sponsors" height="40" width="40"></a>
|
|
<br><a href="javascript:if(confirm('http://www.ctyme.com/sponsor.htm \n\nThis file was not retrieved by Teleport Pro, because it is addressed on a domain or path outside the boundaries set for its Starting Address. \n\nDo you want to open it from the server?'))window.location='http://www.ctyme.com/sponsor.htm'" tppabs="http://www.ctyme.com/sponsor.htm">Shopping</a>
|
|
|
|
</td><td width="65">
|
|
|
|
<a href="javascript:if(confirm('http://talk.ctyme.com/webx.cgi?13@@.ee6b2be \n\nThis file was not retrieved by Teleport Pro, because it is addressed on a domain or path outside the boundaries set for its Starting Address. \n\nDo you want to open it from the server?'))window.location='http://talk.ctyme.com/webx.cgi?13@@.ee6b2be'" tppabs="http://talk.ctyme.com/webx.cgi?13@@.ee6b2be">
|
|
<img src="comment.gif" tppabs="http://graphics.ctyme.com/gif/comment.gif" ALT="Forum" height="40" width="40"></a>
|
|
<br><a href="javascript:if(confirm('http://talk.ctyme.com/webx.cgi?13@@.ee6b2be \n\nThis file was not retrieved by Teleport Pro, because it is addressed on a domain or path outside the boundaries set for its Starting Address. \n\nDo you want to open it from the server?'))window.location='http://talk.ctyme.com/webx.cgi?13@@.ee6b2be'" tppabs="http://talk.ctyme.com/webx.cgi?13@@.ee6b2be">Forum</a>
|
|
|
|
</td><td width="65">
|
|
|
|
<a href="javascript:if(confirm('http://www.ctyme.com/mail.htm \n\nThis file was not retrieved by Teleport Pro, because it is addressed on a domain or path outside the boundaries set for its Starting Address. \n\nDo you want to open it from the server?'))window.location='http://www.ctyme.com/mail.htm'" tppabs="http://www.ctyme.com/mail.htm">
|
|
<img src="mail.gif" tppabs="http://graphics.ctyme.com/gif/mail.gif" ALT="email" height="40" width="40"></a>
|
|
<br><a href="javascript:if(confirm('http://www.ctyme.com/mail.htm \n\nThis file was not retrieved by Teleport Pro, because it is addressed on a domain or path outside the boundaries set for its Starting Address. \n\nDo you want to open it from the server?'))window.location='http://www.ctyme.com/mail.htm'" tppabs="http://www.ctyme.com/mail.htm">EMail</a>
|
|
|
|
</td><td width="65">
|
|
|
|
<a href="javascript:if(confirm('http://www.ctyme.com/map.htm \n\nThis file was not retrieved by Teleport Pro, because it is addressed on a domain or path outside the boundaries set for its Starting Address. \n\nDo you want to open it from the server?'))window.location='http://www.ctyme.com/map.htm'" tppabs="http://www.ctyme.com/map.htm">
|
|
<img src="toc.gif" tppabs="http://graphics.ctyme.com/gif/toc.gif" ALT="Index" height="40" width="40"></a>
|
|
<br><a href="javascript:if(confirm('http://www.ctyme.com/map.htm \n\nThis file was not retrieved by Teleport Pro, because it is addressed on a domain or path outside the boundaries set for its Starting Address. \n\nDo you want to open it from the server?'))window.location='http://www.ctyme.com/map.htm'" tppabs="http://www.ctyme.com/map.htm">Index</a>
|
|
|
|
</td><td width="65">
|
|
|
|
<a href="javascript:if(confirm('http://www.ctyme.com/ \n\nThis file was not retrieved by Teleport Pro, because it is addressed on a domain or path outside the boundaries set for its Starting Address. \n\nDo you want to open it from the server?'))window.location='http://www.ctyme.com/'" tppabs="http://www.ctyme.com/">
|
|
<img src="home.gif" tppabs="http://graphics.ctyme.com/gif/home.gif" ALT="Home" height="40" width="40"></a>
|
|
<br><a href="javascript:if(confirm('http://www.ctyme.com/ \n\nThis file was not retrieved by Teleport Pro, because it is addressed on a domain or path outside the boundaries set for its Starting Address. \n\nDo you want to open it from the server?'))window.location='http://www.ctyme.com/'" tppabs="http://www.ctyme.com/">Home</a>
|
|
|
|
</td><td width="90">
|
|
|
|
<center>
|
|
<FORM ACTION="https://secure.paypal.com/cgi-bin/webscr" tppabs="https://secure.paypal.com/cgi-bin/webscr" METHOD="POST" traget="_blank">
|
|
<INPUT TYPE="hidden" NAME="cmd" VALUE="_xclick">
|
|
<INPUT TYPE="hidden" NAME="business" VALUE="marc@perkel.com">
|
|
<INPUT TYPE="hidden" NAME="return" VALUE="http://www.perkel.com">
|
|
<INPUT TYPE="hidden" NAME="item_name" VALUE="Donation To Support this Site">
|
|
<INPUT TYPE="hidden" NAME="no_intl" VALUE="1">
|
|
<INPUT TYPE="image" SRC="x-click-but7.gif" tppabs="http://images.paypal.com/images/x-click-but7.gif" vspace=9
|
|
NAME="submit" ALT="Make payments with PayPal - it's fast, free and secure!">
|
|
</FORM>
|
|
|
|
</td></tr></table></td></tr></table><p>
|
|
|
|
|
|
<center>
|
|
<p>
|
|
<a href="javascript:if(confirm('http://www.ctyme.com/hosting/index.htm \n\nThis file was not retrieved by Teleport Pro, because it is addressed on a domain or path outside the boundaries set for its Starting Address. \n\nDo you want to open it from the server?'))window.location='http://www.ctyme.com/hosting/index.htm'" tppabs="http://www.ctyme.com/hosting/index.htm" target="_blank">
|
|
<img src="ctymehost.gif" tppabs="http://graphics.ctyme.com/gif/ctymehost.gif"
|
|
border=3 height=60 width=468></a>
|
|
<p>
|
|
<!-- Ad End --->
|
|
|
|
</center>
|
|
<FORM ACTION="http://service.bfast.com/bfast/click" target="_blank">
|
|
<INPUT TYPE="hidden" NAME="siteid" VALUE="30472466" >
|
|
<INPUT TYPE="hidden" NAME="bfpage" VALUE="horizontal">
|
|
<INPUT TYPE="hidden" NAME="bfmid" VALUE="27253343" >
|
|
<INPUT TYPE="hidden" NAME="num" VALUE="30">
|
|
|
|
<table bgcolor=white border=3><tr><td>
|
|
<table bgcolor=white border=0>
|
|
<tr><td>
|
|
<IMG SRC="serve-bfmid=27253343&siteid=30472466&bfpage=horizontal.gif" tppabs="http://service.bfast.com/bfast/serve?bfmid=27253343&siteid=30472466&bfpage=horizontal" BORDER="0" WIDTH="1" HEIGHT="1" align=right NOSAVE >
|
|
<center><b>Search the web with Google</b></center>
|
|
</td></tr><tr><td>
|
|
<TABLE cellpadding=0 cellspacing=5 bgcolor="#FFFFFF">
|
|
<tr><td bgcolor="#0000cc"><IMG SRC="cleardot.gif" tppabs="http://www.google.com/images/cleardot.gif" height=1 border="0" ALT="Google"></td></tr><tr><td>
|
|
<IMG SRC="affiliate_logo.gif" tppabs="http://www.google.com/affiliates/affiliate_logo.gif" border="0" ALT="Google" align="center">
|
|
<INPUT TYPE=text name=q size=30 maxlength=255 value="">
|
|
<INPUT type=submit name=sa VALUE="Go">
|
|
</td></tr>
|
|
<tr><td bgcolor="#0000cc"><IMG SRC="cleardot.gif" tppabs="http://www.google.com/images/cleardot.gif" height=1 border="0" ALT="Google"></td></tr></TABLE>
|
|
</td></tr></table>
|
|
</tr></td></table>
|
|
</FORM>
|
|
|
|
</center>
|
|
|
|
|
|
<p><img src="rbline.gif" tppabs="http://graphics.ctyme.com/gif/rbline.gif" width="100%" alt="------"><p>
|
|
|
|
<!-- Bottom Link End -->
|
|
|
|
</BODY>
|
|
</HTML>
|