Function NnetScnPrp() | Xbase++

Scans a particular bindery object for associated properties.

NnetScnPrp( <cObjectName>            , ;
            <nObjectType>            , ;
            <cScanPropertyName>      , ;
            <@nSequence>             , ;
           [<@nPropertyFlag>]        , ;
           [<@nPropertySecurity>]    , ;
           [<@lPropertyHasValue>]    , ;
           [<cFileServer|nConnectID>]  ;  // Default: NnetSname()
          ) --> cPropertyNameFound

Returns the name of the found property or a null string when no property is found.

The function is used to search a particular bindery object for properties whose names match the search condition <cScanPropertyName>. This is a string which may contain wildcard characters like "*" or "?". Multiple properties with matching names are found using subsequent calls to NnetScnPrp().

The name of the bindery object to be scanned.

The type of the bindery object to be scanned. #define constants from XBTNETW.CH are used for this parameter.

<@nSequence>

This parameter specifies the sequence number where to start the search from. It is of interest for subsequent calls to NnetScnPrp() only and must be passed by reference in order to find multiple properties matching the search string. Pass -1 for the first call. When the function returns <nSequence> contains the sequential number of the found property.

<@nPropertyFlag>

This parameter is of interest only when NnetScnPrp() has returned. If passed by reference <nPropertyFlag> indicates the type of the found property:

0 -> Static property item

1 -> Dynamic property item

2 -> Static property set

4 -> Dynamic property set

<@nPropertySecurity>

This parameter is of interest only when NnetScnPrp() has returned. If passed by reference <nPropertySecurity> contains the security of the found property (refer to NnetPrpSec() for security).

<@lPropertyHasValue>

This parameter is of interest only when NnetScnPrp() has returned. If passed by reference the value .T. signals that the found property has a value.

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.

Function NnetScnPrp() Foundation