TCPIP_MDNS_ServiceUpdate Function

C

MDNSD_ERR_CODE TCPIP_MDNS_ServiceUpdate(
    TCPIP_NET_HANDLE netH, 
    uint16_t port, 
    const uint8_t * txt_record
);

Description

This function is used by the end-user application to update its service, which was previously registered. With this function, the end-user application updates the port number on which the service is running. It can also update the additional information of service. For example, the default page can be updated to new page and corresponding page name can be input to this function to update all peer machines. The modified service will be announced with new contents on local network.

This is an optional function and should be invoked only if it is necessary.

Preconditions

TCPIP_MDNS_ServiceRegister must be invoked before this call.

Parameters

ParametersDescription
netHHandle of the network to perform the service update.
portPort number on which service is running.
txt_recordString of additional information (e.g., "index.htm") for HTTP-service.

Returns

  • MDNSD_ERR_CODE - Returns error-code to indicate whether or not registration is successful:

    • MDNSD_SUCCESS - returns on success of call.

    • MDNSD_ERR_INVAL - When the input parameters are invalid or if the function is invoked in invalid state.