web_reg_save_param_attrib
Example: web_reg_save_param_attrib | Correlation Functions for C |
Registers a request to save dynamic data in a server response that has been formatted as HTML. The data is saved to a parameter.
C Language
int web_reg_save_param_attrib("ParamName=<output parameter name>", TagName=<value>, Extract=<value>, [Name=<value>, ] [Id=<value>, ] [Class=<value>, ] [Type=<value>, ]<List of Attributes>, <SEARCH FILTERS>,LAST );
Argument | Description |
---|---|
ParamName | The name of the parameter to create. |
TagName | The name of HTML element. |
Extract | The name of HTML attribute whose value will be saved to parameter. |
Name | The value of the HTML element's "name” attribute. |
Id | The value of the HTML element's “id” attribute. |
Class | The value of the HTML element's “class” attribute. |
Type | The value of the HTML element's “type” attribute. For example, for the INPUT element, Type can be "hidden". |
List of Attributes | For details of each attribute, see Attributes for Save Parameter Registration Functions. Attribute value strings (e.g., "NotFound=warning") are not case-sensitive. See the Restrictions. |
SEARCH FILTERS | Specifies the sections of the buffer to search for the data in. See Search Filters for Save Parameter Registration Functions See the Restrictions. |
LAST | A marker that indicates the end of the argument list. |
Return Values
This function returns LR_PASS (0) on success, and LR_FAIL (1) on failure.
Restrictions
For the ContentType and HeaderNames search filters, Scope specifiers are not supported.
Mixed quotes types are not supported for the target attributes, for example,
name=‘Tom”
.When the innerHTML parameter is specified, it only supports the simple text innerHTML (all the characters between the current end tag and the next start tag). For example, this function will find “Development” correctly, but will not to detect the
img
element as the innerHTML of thetd
tag.
<a class="contextBarText" href="#">Development</a>
<td class="contextBarText" align="left">
<img src="/LCSW/images/context_arrow.gif" alt="" border="0" align="absmiddle">
</td>
For more information on the DFES argument, see Attributes for Save Parameter Registration Functions.
For more information on the HeaderNames arguments, see Search Filters for Save Parameter Registration Functions
For more information on the RelFrameID argument, see Search Filters for Save Parameter Registration Functions and RelFrameID Attribute.