FUNCTION xpfGetHashedAttrInstanceEx (modelId            : GENERIC;
                                     entityId           : GENERIC;
                                     attrId             : GENERIC;
                                     attrValue          : GENERIC)
                                     matchingInstanceId : GENERIC;

Function to search an given EDMpersitentAttrHashTable for an element (instanceId) that matches a specified string value.

By intoducing the xpxDefinePersistentAttrHashTableBNEx() function, it is possible to have more than one EDMpersitentAttrHashTable for the same attribute in the same model. The functions xpfGetHashedAttrInstance(), xpxGetHashedAttrInstances(), xpfGetHashedAttrInstances() will not disinguish between different EDMpersitentAttrHashTables for the same attribute, since only the model and the attribute are used for identifying the actual EDMpersitentAttrHashTable. The functions xpfGetHashedAttrInstanceEx() and xpfGetHashedAttrInstancesEx() uses the combination of model, entity and attribute to identify an EDMpersitentAttrHashTable, i.e., these function can also disinguish between different EDMpersitentAttrHashTables for the same attribute in a model.

Arguments

1	Type	Name	Comment
2	GENERIC	modelId	Specifies the EDMdataModel to search in. The combination of the arguments "modelId", "entityId" and "attrId" uniquely identifies an EDMpersitentAttrHashTable in an EDMdatabase.
3	GENERIC	entityId	An enityId that is part of the actual EDMpersitentAttrHashTable identification
4	GENERIC	attrId	An attributeId that is part of the actual EDMpersitentAttrHashTable identification
5	STRING	attrValue	Specifies the actual string value to search for in the given EDMpersitentAttrHashTable.

Return Value

Type	Name	Comment
GENERIC	matchingInstanceId	When the xpfGetHashedAttrInstanceEx() operation is successfully performed, the instanceId of the EDMpersitentAttrHashTable entry that matches the string value specified in the "attrValue" argument will be returned else the constant xpxNULLID will be returned. The value INDETERMINATE (?) will be returned when the xpfGetHashedAttrInstanceEx() operation fails. Exception handling should be used to handle error conditions in the actual xpfGetHashedAttrInstanceEx() operation.

Options

Example

Arguments

Return Value

Options

Example

See also

Filter by label