L_VecInit

#include "lvkrn.h"

L_LVKRN_API L_INT L_VecInit(pVector)

pVECTORHANDLE pVector;

/* pointer to a vector handle */

Initializes the fields in a vector handle.

Parameter

Description

pVector

Pointer to the vector handle to be initialized.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

You must call this function before calling L_VecCopy.

Required DLLs and Libraries

LVKRN

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

See Also

Functions:

L_VecCopy

Topics:

 

Example

This example will make a copy of a vector handle. 

L_INT VecInitExample(pVECTORHANDLE pVector)
{
   VECTORHANDLE TmpVector;  /* Temporary vector handle */
   L_INT nRet;       /* Return value */

   /* Initiate the temporary vector handle */
   nRet = L_VecInit( &TmpVector );
   if(nRet != SUCCESS)
      return nRet;

   /* Make a copy */
   nRet = L_VecCopy( &TmpVector, pVector, VECTOR_FLAGS_REPLACE );
   if( nRet != SUCCESS )
      return nRet;
   /* 
   ...
   Do something with TmpVector
   ...
   */

   /* Destroy temporary vector before returning. */
   nRet = L_VecFree( &TmpVector );

   return nRet;
}