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> usrgrplst()</b> http://www.X-Hacker.org [<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 UsrGrpLst()
------------------------------------------------------------------------------
 Purpose:
 List the groups of which the user is a member.

 Syntax:
 lpszGroupName = UsrGrpLst( lpszUserName, wIndex )

 Parameters:
 lpszUserName The user name.
 wIndex       The index into the list of group names.

 Returns:
 A character string of length 47.

 Description:
 UsrGrpLst() is used to obtain a list of the groups of which the user
 specified by lpszUserName is a member. wIndex is an offset into the list
 at which to start. UsrGrpLst() should be called initially with wIndex
 set to 1 and then repeatedly with wIndex incremented each time until an
 empty string is returned, signifying the end of the list.

 Returns an empty string on the first call if the user is not a member of
 any groups or if an error occurs.

 Example:
 // To list the groups of which user TONY is a member:
 wIndex = 1
 lpszGroup = UsrGrpLst( "TONY", wIndex )
 do while !empty ( lpszGroup )
    ? lpszGroup
    wIndex++
    lpszGroup = UsrGrpLst( "TONY", wIndex )
 enddo

 Notes:
 UsrGrpLst() calls SetPrpValGet() to scan a user's
 GROUPS_I'M_IN set property value.

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

See Also: GrpUsrTst() GrpUsrLst() FSGrpAdd() FSGrpDel() GrpNmeGet()

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