edmiGetHashedAttrInstanceBN

EdmiError  edmiGetHashedAttrInstanceBN  (SdaiModel     modelId,
                                       SdaiString    entityName,
                                       SdaiString    attributeName,
                                       SdaiString    attrStringValue,
                                       SdaiInteger   attrIntegerValue
                                       SdaiInstance  *instance);

Searched the specified model for the instance id of the instance where the specified attribute has exactly the specified value. The attribute is specified by name via the arguments entityName and attributeName. If the attribute type is of string type use the attrStringValue to specify the attribute value. If the attribute type is of integer type, use the attrIntegerValue to specify the attribute value. 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 edmiGetHashedAttrInstancesBN. If no attribute hash table is defined for the specified attribute, no sequential search is performed and the function returns an error code.

Arguments

Type	Name	Comment
SdaiModel	modelId	A numeric modelID that uniquely identifies the model of interest in the EDMdatabase. The modelID is returned from the functions: sdaiCreateModel , sdaiCreateModelBN , sdaiOpenModelBN , edmiGetModel , edmiGetModelBN , sdaiGetInstanceModel
SdaiString	entityName	Specify the name of the instance type, i.e. the name of the entity that defines the instance type. Entity names are case insensitive.
SdaiString	attributeName	Specifies the name of the attribute. Attribute names are case insensitive.
SdaiString	attrStringValue	is used to specify the hash table key for hash tables of SdaiString data type
SdaiInteger	attrIntegerValue	is used to specify the hash table key for hash tables of SdaiInstance, and EdmPackedDate data types
SdaiInstance	*instance	Address of the variable where to return the instance id of the found instance.

Return Value

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

Options

Example

 <example>

EDMsix

edmiGetHashedAttrInstanceBN

Arguments

Return Value

Options

Example

See also

Filter by label