Purpose

Sends a UDP request to all DoIP-capable vehicles in the local subnet to identify themselves.

Format 

        long ndDoIPSendVehicleIdentRequest(
       TD1 *diagRef);

Input

diagRef

Specifies the handle for the diagnostic session, obtained from ndOpenDiagnosticOnIPStack and passed to subsequent diagnostic functions. Normally, it is not necessary to manually manipulate the elements of this struct. Output

Return Value

The return value indicates the function call status as a signed 32-bit integer. Zero means the function executed successfully. A negative value specifies an error, which means the function did not perform the expected behavior. A positive value specifies a warning, which means the function performed as expected, but a condition arose that may require attention.

Use the ndStatusToString function to obtain a descriptive string for the return value.

Description

ndDoIPSendVehicleIdentRequest sends a Vehicle Identification Request to all DoIP entities in the local subnet.

Usually, this is done as part of ndDoIPGetEntities and does not need to be executed separately.

To specify a different broadcast address than the local subnet on the default Network Interface Controller, use the ndDoIPSendVehicleIdentRequestEx function.