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.