# null

# SomeIpProvidedFieldAddConsumer

[Valid for](../../../../Shared/FeatureAvailability.md): CANoe DE • CANoe4SW DE

## Function Syntax

* `long SomeIpProvidedFieldAddConsumer(dword pfHandle, dword remoteIPv4Address, dword remoteUDPPort, dword remoteTCPPort); // form 1`
* `long SomeIpProvidedFieldAddConsumer(dword pfHandle, byte remoteIPv6Address[], dword remoteUDPPort, dword remoteTCPPort); // form 2`
* `long SomeIpProvidedFieldAddConsumer(dword pfHandle, IP_Endpoint remoteIPEndpoint); // form 3`

## Description

Adds a consumer to a provided field. Afterwards the field notifications will be sent to this consumer.

## Parameters

* **pfHandle**: Provided field handle (may be retrieved by [SomeIpGetProvidedObjectHandle](CAPLfunctionSomeIpGetProvidedObjectHandle.md))
* **remoteIPv4Address**: IPv4 address of the consumer. In network byte order.
* **remoteIPv6Address**: IPv6 address of the consumer
* **remoteUDPPort**: An UDP port number of the consumer or zero if there is none
* **remoteTCPPort**: A TCP port number of the consumer or zero if there is none
* **remoteIPEndpoint**: Object of type `IP_Endpoint` that contains the address/port of the consumer.

## Return Values

* **0**: The function was successfully executed
* **>0**: [Error code](../../CAPLfunctionsSOMEIPILErrorCodes.md)

## Example

—
