DH_CreatePoint

Cogent API and Utilities: Version 4.1
Prev |  | Next

# `DH_CreatePoint`

`DH_CreatePoint` -- constructs a point.

## Syntax

    #include <cogdb.h>

``ST_STATUS DH_CreatePoint`(IP_Task* myself, PT_pCPOINT ppoint, IP_Msg* hmsg, ER_hLIST elist);`

## Arguments

`myself`

  The task handle associated with this task. This should always be the return value from `IP_NserveInit`.

`ppoint`

  A pointer to a Cascade DataHub point structure. All fields are valid, and will be treated by the write, but in the first call on a point the address field must be zero. It will be filled in automatically. This address will be valid so long as the point exists in the datahub, and if, in subsequent `DH_*` functions, the address is provided for this point, the function will run slightly faster.

`hmsg`

  A handle to a previously allocated message structure (using IP_MsgCreate) providing enough buffer space to handle the inter-process communication associated with the datahub transaction.

`elist`

  A return value containing error information. This is unimplemented in this version, and should be `NULL`.

## Returns

`ST_OK` on success, `ST_ERROR` on failure, or some other value of `ST_STATUS`.

## Description

This function constructs a point in the Cascade DataHub. The value and confidence assigned to the point are both `0`.

## See Also

DH_ReadPoint, DH_RegisterPoint, DH_WritePoint

Prev | Home | Next
`DH_AppendString` | Up | `DH_FindPointAddress`

Copyright 1995-2002 by Cogent Real-Time Systems, Inc.