Functions and Directives Functions and Directives

Function NnetRdItm() Foundation

Reads a 128-byte value segment from a property item.

Syntax
NnetRdItm( <cObjectName>             , ;
           <nObjectType>             , ;
           <cPropertyName>           , ;
           [<nValueSegment>]         , ;  // Default:  1
           [<lBinaryValue>]          , ;  // Default: .F.
           [<cFileServer|nConnectID>]  ;  // Default: NnetSname()
         ) --> cPropertyValue
Return

<lBinaryValue> = .F. (Default)

A string up to the first Chr(0) of the specified value segment is returned.

<lBinaryValue> = .T.

The entire value segment is returned as a 128-byte string.

In case of an error NnetRdItm() returns a null string ("").

Description

The user must have read access to the property. The accessed property must be a property item. Use function NnetRdSet() to read values from property sets.

<cObjectName>

An uppercase string of max. 48 characters = the name of the bindery object which has the property <cPropertyName>.

<nObjectType>

#define constant from XBTNETW.CH beginning with OBJ_ is used to specify the object's type.

<cPropertyName>

An uppercase string of max. 15 characters = the property's name.

Feedback

If you see anything in the documentation that is not correct, does not match your experience with the particular feature or requires further clarification, please use this form to report a documentation issue.