ndDoIPSendVehicleIdentReqVINEx

Automotive Diagnostic Command Set Toolkit Help

Edition Date: November 2018

Part Number: 372140J-01

»View Product Info
Download Help (Windows Only)

Purpose

Sends a UDP request to all DoIP-capable vehicles with a certain VIN (Vehicle Identification Number) on the specified broadcast address to identify themselves.

Format

long ndDoIPSendVehicleIdentReqVINEx(
       TD1 *diagRef,
       char broadcastAddress[],
       char VIN[]);

Input

diagRef

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

broadcastAddress

Defines the broadcast IP address to which the request is sent. Usually, this is 255.255.255.255, meaning a broadcast to the local subnet on the default Network Interface Controller. It can, however, be overridden to specify a different broadcast address, for example on a different Network Interface Controller.

VIN

The 17-character Vehicle Identification Number of the DoIP entity that is assumed to respond (zero-terminated string).

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

ndDoIPSendVehicleIdentReqVINEx sends a Vehicle Identification Request to all DoIP entities on the specified broadcast address identified by the given VIN.

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

WAS THIS ARTICLE HELPFUL?

Not Helpful