Function ziAPIDiscoveryFind#

ZIResult_enum ziAPIDiscoveryFind(ZIConnection conn, const char *deviceAddress, const char **deviceId)#

Perform a Discovery property look-up for the specified deviceAddress and return its device ID. Attention! This invalidates all pointers previously returned by ziAPIDiscovery* calls. The deviceId need not be deallocated by the user.

See also

ziAPIDiscoveryFindAll, ziAPIDiscoveryGet, ziAPIDiscoveryGetValueI, ziAPIDiscoveryGetValueS

Parameters:

  • conn – [in] Pointer to ZIConnection with which the value should be retrieved.

  • deviceAddress – [in] The address or ID of the device to find, e.g., ‘uhf-dev2006’ or ‘dev2006’.

  • deviceId – [out] The ID of the device that was found, e.g. ‘DEV2006’.

Returns:

  • ZI_INFO_SUCCESS

  • Other return codes may also be returned, for a detailed error message use ziAPIGetLastError.