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 http-equiv="Content-Style-Type" content="text/css"> 7<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 7.0.0.0 for Windows"> 8<title>DWC_NdSetAttr</title> 9<LINK rel="stylesheet" href="../css/nitro.css" type="text/css"> 10</head> 11 12<body> 13<a name="dwc__nd_8h_1bd4be75a25d160506b7a4a9232ee2b40"></a> 14<h1 align="left">DWC_NdSetAttr</h1> 15<h2>Syntax</h2> 16 17<dl> 18 <dd> 19<CODE>#include <dwc.h></CODE><BR> 20 <BR> 21 <PRE><CODE>BOOL <a href=DWC_NdSetAttr.html#dwc__nd_8h_1bd4be75a25d160506b7a4a9232ee2b40>DWC_NdSetAttr</a>(const char *attr1, 22 const char *attr2, 23 const char *attr3);</CODE></PRE></dd> 24</dl> 25 26<h2>Arguments</h2> 27 28<TABLE border="1" width="100%"> 29 <TBODY> 30 31 <TR> 32<TD width="13%"><EM><STRONG>attr1</STRONG></EM></TD> 33<TD width="87%">Pointer to the first attribute string to set.</TD> 34 </TR> 35 36 <TR> 37<TD width="13%"><EM><STRONG>attr2</STRONG></EM></TD> 38<TD width="87%">Pointer to the second attribute string to set.</TD> 39 </TR> 40 41 <TR> 42<TD width="13%"><EM><STRONG>attr3</STRONG></EM></TD> 43<TD width="87%">Pointer to the third attribute string to set.</TD> 44 </TR> 45 46 </TBODY> 47</TABLE> 48 49<h2>Return Values</h2> 50 51<TABLE border="1" width="100%"> 52 <TBODY> 53 54 <TR> 55<TD width="13%"><EM><STRONG>TRUE</STRONG></EM></TD> 56<TD width="87%">Successful.</TD> 57 </TR> 58 59 <TR> 60<TD width="13%"><EM><STRONG>FALSE</STRONG></EM></TD> 61<TD width="87%">Failed. Use the <a href=DWC_GetLastErrorEx.html#dwc__error_8h_118bd79f5d5151259c19c4e552e5e633b><code>DWC_GetLastErrorEx</code></a> function to obtain error information.</TD> 62 </TR> 63 64 </TBODY> 65</TABLE> 66 67<H2>Description</H2> 68<p>Sets the attribute strings for the Download library.</p><p>Attribute strings are specified as ASCII strings of no more than 10 characters and must end with a <CODE>NULL</CODE> character.<br>The download server uses these attribute strings to determine which files can be downloaded.<br>The three attribute strings are evaluated using the method described below. If all three strings are found to indicate that the file is downloadable, the file is treated as downloadable.</p><p><ul><li>If a value is set for an attribute string, it is compared with the string set on the server. If the two match exactly, the file is judged to be downloadable.<br></li><li>If an attribute string is blank, the file is judged as unconditionally downloadable.<br></li></ul></p><p>If the <a href=DWC_NdGetFileListNumAsync.html><CODE>DWC_NdGetFileListNumAsync</CODE></a>, <a href=DWC_NdGetFileListAsync.html><CODE>DWC_NdGetFileListAsync</CODE></a>, or <a href=DWC_NdGetFileAsync.html><CODE>DWC_NdGetFileAsync</CODE></a> function is called without calling this function, all attribute strings are treated as if they were blank.</p> 69 70<h2>See Also</h2> 71<p> 72 73<CODE><A href="DWC_NdGetFileListNumAsync.html">DWC_NdGetFileListNumAsync<BR></A></CODE> 74 75<CODE><A href="DWC_NdGetFileListAsync.html">DWC_NdGetFileListAsync<BR></A></CODE> 76 77<CODE><A href="DWC_NdGetFileAsync.html">DWC_NdGetFileAsync</A></CODE> 78 79</p> 80 81<H2>Revision History</H2> 82<DL> 83 84<DT><para>1.4.7</DT> 85<DD>Added a description of usage.</DD> 86 87</DL> 88<hr><p>CONFIDENTIAL</p></body> 89</html> 90