web_reg_save_param_attrib

Example: web_reg_save_param_attribCorrelation 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.
TagNameThe name of HTML element.
Extract The name of HTML attribute whose value will be saved to parameter.
NameThe value of the HTML element's "name” attribute.
Id The value of the HTML element's “id” attribute.
ClassThe 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.

LASTA 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 the td 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.

Concept Link IconSee Also

web_reg_save_param_ex