DWC_NdSetAttr

Syntax

#include <dwc.h>

BOOL DWC_NdSetAttr(const char *attr1,
                   const char *attr2,
                   const char *attr3);

Arguments

attr1	Pointer to the first attribute string to set.
attr2	Pointer to the second attribute string to set.
attr3	Pointer to the third attribute string to set.

Return Values

TRUE	Successful.
FALSE	Failed. Use the `DWC_GetLastErrorEx` function to obtain error information.

Description

Sets the attribute strings for the Download library.

Attribute strings are specified as ASCII strings of no more than 10 characters and must end with a NULL character.
The download server uses these attribute strings to determine which files can be downloaded.
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.

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.
If an attribute string is blank, the file is judged as unconditionally downloadable.

If the DWC_NdGetFileListNumAsync, DWC_NdGetFileListAsync, or DWC_NdGetFileAsync function is called without calling this function, all attribute strings are treated as if they were blank.

Revision History

1.4.7: Added a description of usage.