1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<html>
3
4<head>
5<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
6<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 7.0.0.0 for Windows">
7<META http-equiv="Content-Style-Type" content="text/css">
8<title>FS_FindArchive</title>
9<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
10</head>
11
12<body>
13
14<h1 align="left">FS_FindArchive <img src="../../image/NTR.gif"align="middle"><img src="../../image/TWL.gif" align="middle"></h1>
15<h2>Syntax</h2>
16
17<dl>
18  <dd>
19<CODE>#include &lt;nitro/fs.h&gt;</CODE><BR>
20  <BR>
21  <CODE><A href="../fs_archive_type.html">FSArchive</a>*	FS_FindArchive(const char *name, int name_len);</CODE><br>
22  <br>
23  </dd>
24</dl>
25
26<h2>Arguments</h2>
27<TABLE border="1" width="100%">
28  <TBODY>
29    <TR>
30      <TD width="13%"><EM><STRONG>name</STRONG></EM></TD>
31      <TD width="87%">Pointer to the string storing the search target name</TD>
32    </TR>
33    <TR>
34      <TD width="13%"><EM><STRONG><code><EM><STRONG>name_len</STRONG></EM></code></STRONG></EM></TD>
35      <TD width="87%">The string length of <em><code>name</code></em></TD>
36    </TR>
37  </TBODY>
38</TABLE>
39
40<h2>Return Values</h2>
41<p>If there is already an archive registered with the specified name, the function returns the pointer to that archive. Otherwise, it returns <code>NULL</code>.</p>
42
43<H2>Description</H2>
44<P>Searches to determine whether or not an archive with the specified name has been registered in the file system. Returns the pointer to the archive if it exists. The pointer is returned even if the archive has not been loaded. <BR>
45<h2>See Also</h2>
46<p><code><a href="../fs_archive_type.html">FSArchive</a></code>, <a href="../fs_archive_name_len_max_const.html">FS_ARCHIVE_NAME_LEN_MAX</a></code>, <a href="FS_RegisterArchiveName.html">FS_RegisterArchiveName</a></code>, <a href="FS_LoadArchive.html">FS_LoadArchive</a></code></P>
47<H2>Revision History</H2>
48<P>2004/07/12 Initial version.</P>
49<hr><p>CONFIDENTIAL</p></body>
50</html>
51