NWAPPGetFolders(3nw)


NWAPPGetFolders -- creates a linked list of all the folders for the current user, and the objects that reside in them

Synopsis

   #include <nwapp.h> 
   

APP_DESKTOP_FOLDER* N_API N_EXPORT NWAPPGetFolders (APP_CONTEXT_HANDLE dContext, nint16 folderType, nint16 numContainers, pnstr8 userName);

Description

The parameters are as follows:

dContext
(IN) Specifies the valid directory context to scan for objects.

folderType
(IN) Specifies the type of list to return: APP_AUTO_START or APP_DESKTOP.

numContainers
(IN) Specifies the number of containers to include the search . -1 specifies to start searching the Directory tree from the userName parameter to the top for folders.

userName
(IN) Points to the user for which to return a list. NULL specifies to return a list for the current user; otherwise, NWAPPGetFolders will return a list for the user name passed in. userName must be relative to dContext.

Return values

If successful, NWAPPGetFolders returns a pointer to the first node in the list of auto start folders. Otherwise, it returns NULL.

Notices

NWAPPGetFolders returns a list of APP_DESKTOP_FOLDER objects. Each of these desktop folders has a linked list of APP_DIRECTORY_OBJECT nodes.

To get the actual attribute values for a given node, call NWAPPGetObjectAttributes using the fullName field of APP_DIRECTORY_OBJECT.

Services

NetWare Application Launcher (NAL) Services

References

NWAPPFreeGetFolders(3nw),


30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.