xpfGetHashedAttrInstance

FUNCTION xpfGetHashedAttrInstance (modelId            : GENERIC;
                                   attrId             : GENERIC;
                                   attrValue          : GENERIC)
                                   matchingInstanceId : GENERIC;      

This function is used to search the specified model for the instance id of the instance where the specified attribute has exactly the specified value. The attribute is specified by the attribute id. The argument <attrValue> is used to specify the attribute value, this value can be a string or integer. This function returns only one instance id, which implies that you only should use this function if the attribute value is defined to be unique. If the attribute value may occur in more than one instance, use xpxGetHashedAttrInstances.

If no attribute hash table is defined for the specified attribute, no sequential search is performed and the function returns an error code. See the functions xpxDefinePersistentAttrHashTable and xpxDefinePersistentAttrHashTableBN.

The matching instance found is returned by the function. If no matching instance is found then the function returns xpxINDETERMINATE.

Arguments


Error rendering macro 'excerpt-include' : User 'null' does not have permission to view the page 'US:_a_modelId_XPX'.
Error rendering macro 'excerpt-include' : User 'null' does not have permission to view the page 'US:_a_attrId'.
Error rendering macro 'excerpt-include' : User 'null' does not have permission to view the page 'US:_a_attrValue'.

Return Value


 

Error rendering macro 'excerpt-include' : User 'null' does not have permission to view the page 'US:_r_matchingInstanceId'.

Options


 

 

Example


<example missing>

 

See also

Filter by label

There are no items with the selected labels at this time.

 

 

                               

Â