L_VecGetLayerByName

#include "lvkrn.h"

L_INT EXT_FUNCTION L_VecGetLayerByName(pVector, pszName, pLayer)

const pVECTORHANDLE pVector;

/* pointer to a vector handle */

const L_TCHAR L_FAR * pszName;

/* layer name */

pVECTORLAYER pLayer;

/* pointer to a vector layer */

Gets the layer with the specified name, in the specified vector handle.

Parameter

Description

pVector

Pointer to the vector handle.

pszName

Character string that contains the name of the layer to get.

pLayer

Pointer to a VECTORLAYER structure to be updated with the layer handle, if the layer is found.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

If two or more layers in a vector handle have the same name, this function will get the first layer found.

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_VecGetLayerCount, L_VecGetLayerByIndex, L_VecGetLayer.

Topics:

Working with Vector Layers

Example

For an example, refer to L_VecDeleteLayer.