Retro video games delivered to your door every month!
Click above to get retro games delivered to your door ever month!
X-Hacker.org- Novlib 3.30 Online Reference - <b> objprplst()</b> http://www.X-Hacker.org [<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 ObjPrpLst()
------------------------------------------------------------------------------
 Purpose:
 List the properties of an object.

 Syntax:
 lpszPropertyName = ObjPrpLst( lpszObjectName,
                    wObjectType, lpszPropertyName, bStartFlag )

 Parameters:
 lpszObjectName   The object name.
 wObjectType      The object type.
 lpszPropertyName The property to search for.
 bStartFlag       Flag signifying start of list.

 Returns:
 A character string of length 15.

 Description:
 ObjPrpLst() searches for a specified property or properties in the
 NetWare bindery associated with the given object lpszObjectName and type
 wObjectType.

 ObjPrpLst() must first be called with bStartFlag set to TRUE, using
 lpszObjectname for the object name, wObjectType for its type and a search
 pattern lpszPropertyName. lpszPropertyName can be the complete name of the
 property, or a partial name including wild cards "*" and "?".
 ObjPrpLst() will return the first property that meets the search
 criteria.

 ObjPrpLst() can then be called iteratively with bStartFlag set to
 FALSE to return other properties that meet the same search criteria until
 an empty string is returned at the end of the list.

 ObjPrpLst() returns an empty string on the first pass if an error
 occurs, or if it could not find a match.

 Example:
 // To verify the existence of a user TAYLOR's IDENTIFICATION property:
 if (!empty(ObjPrpLst("TAYLOR",OT_USER,"IDENTIFICATION",TRUE)))
    ? "User TAYLOR has an IDENTIFICATION property."
 endif

 // To display all the bindery object properties of the user JOHN:
 lpszProperties = ObjPrpLst( "JOHN", OT_USER, "*", TRUE )
 do while !empty( lpszProperties )
    ? lpszProperties
    lpszProperties = ObjPrpLst( "JOHN", OT_USER, "*", FALSE )
 enddo

 Notes:
 For more information on bindery object properties and their
 property values, please turn to the reference in Chapter 3, Bindery
 Functions, and to the tables in the Appendix.

 After an empty string is returned, check NWErrorGet().

See Also: PrpValTst() PrpFlgGet() PrpSecGet() FSObjLst() ObjPrpTst()

Online resources provided by: http://www.X-Hacker.org --- NG 2 HTML conversion by Dave Pearson