Page Comparison

...

Code Block

language	cpp
theme	Confluence

EdmiError edmiRemoteGetHashedAttrInstancesBN(SdaiServerContext serverContextId, 
                                              SdaiModel         modelId,   
                                              SdaiString        entityName,
                                              SdaiString        attributeName, 
                                              SdaiString        attrStringValue,
                                              SdaiInteger       attrIntegerValue,  
                                              SdaiInteger       maxBufferSize,   
                                              SdaiInteger       *index,      
                                              SdaiInteger       *numberOfHits,   
                                              SdaiInstance      *resultBuffer,  
                                              SdaiInvocationId  *edmiInvocationId);

Search the specified model for the instances with an attribute value equal to the specified attribute. The attribute is specified by name via the arguments <entityName> and <attributeName>. Number of instances found is returned via the argument <numberOfHits>.

...

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
SdaiServerContext	serverContextId	Context identification, from edmiDefineServerContext
SdaiModel	modelId	The modelId that uniquely identifies the edmModel in the remote EDMdatabase ^.
SdaiString	entityName	The name of the entity that defines the attribute of interrest. Entity names are case insensitive.
SdaiString	attributeName	The name of the attribute of interrest. Attribute names are case insensitive.
SdaiString	attrStringValue	If the attribute is of <string type>, use this argument to specify the attribute value to search for.
SdaiInteger	attrIntegerValue	If the attribute is of <integer type>, use this argument to specify the attribute value to search for.
SdaiInteger	maxBufferSize	The size of the buffer in which the indexes of all the matching aggregate elements will be returned. The number of returned indexes will never exceed this number.
SdaiInteger	*index	In: The index of the aggregate element to start reading from. The first element is indexed zero. Hence the legal index range is: [ 0 <= index < N ] , where N is the number of elements in the aggregate. Out: The index of the "last returned matching element". If the return value is incremented by one, it may be used as input value for succeeding calls to the same function. This way, the second call will start reading aggregate elements where the first call finished. this will reduce the required size of the <resultBuffer>.
SdaiInteger	*numberOfHits	In: The maximum number of matching aggregate element indexes to return.If this number is greater than the limitation specified by the <maxBufferSize> argument, the maximum number of hits will be overruled by the value given in the <maxBufferSize> argument. Out: The number of matching aggregate element indexes returned.
SdaiInstance	*resultBuffer	A buffer, allocated by the calling application, that will receive the indexes of the matching aggregate elements. Use the <maxBufferSize> argument to prevent writing past the end of this buffer.
SdaiInvocationId	*edmiInvocationId	Currently not used.

...

Return Value

...

Insert excerpt

	US:_r_EDMInterface
	US:_r_EDMInterface
nopanel	true

Options

...

Example

...

Code Block

language	cpp

Versions Compared

Old Version 1

New Version Current

Key

Arguments

Return Value

Options

Example

See also