7.5 UA_ServerGetIndexByUriList
| FB-Name | UA_ServerGetIndexByUriList | |||
| This Function Block is used to get several server-indexes of server-URIs | ||||
| VAR_INPUT | ||||
| B | Execute | BOOL | FB performs its task on rising edge on this input. | |
| B | ConnectionHdl | DWORD | Connection handle. | |
| B | ServerUrisCount | UINT | Number of ServerUris in Array of ServerUris. | |
| B | ServerUris | ARRAY OF Vendor specific | Shall be STRING or WSTRING. The recommendation for new implementation is to use WSTRING. Array of Vendor specific with the ServerUris. See Constants of Array Lengths (MAX_ELEMENTS_NAMESPACES) | |
| B | Timeout | TIME | Maximum time to response. | |
| VAR_OUTPUT | ||||
| B | Done | BOOL | FB has completed its task. | |
| B | Busy | BOOL | The FB is not finished and new output values are to be expected. | |
| B | Error | BOOL | Signals that an error has occurred within the FB. | |
| E | ErrorID | DWORD | Error code. | |
| B | ErrorIDs | ARRAY OF DWORD | Error codes. Array shall be the same number of elements as ServerUrisCount. See Constants of Array Lengths (MAX_ELEMENTS_NAMESPACES) | |
| B | ServerIndexes | ARRAY OF UDINT | Server Indexes. Array shall be the same number of elements as ServerUris. See Constants of Array Lengths (MAX_ELEMENTS_NAMESPACES) | |
Notes: Reads the Server-Object ServerArray (NS:0; Id: 2254) and returns the indexes of the requested elements which can be used in subsequent calls where the Server-Array-Index is required - e.g. UA_Browse. This is a convenient function call – could also be done with ReadList and the returned unknown array length of the ServerArray could be evaluated in the user program. In case the requested ServerUri is not found the error PLCopenUA_Bad_NSNotFound will be returned in the corresponding ErrorIDs. | ||||
| UA_ServerGetIndexByUriList | ||||||
| BOOL | Execute | Done | BOOL | |||
| DWORD | ConnectionHdl | Busy | BOOL | |||
| UINT | ServerUrisCount | Error | BOOL | |||
| ARRAY of Vendor specific | ServerUris | ErrorID | DWORD | |||
| TIME | Timeout | ErrorIDs | ARRAY of DWORD | |||
| ServerIndexes | ARRAY of UINT | |||||