NWAPPGetObjectAttributes(3nw)


NWAPPGetObjectAttributes -- returns a list of attribute names and types for the specified object

Synopsis

   #include <nwapp.h> 
   

APP_OBJECT_ATTRIBUTE* N_API N_EXPORT NWAPPGetObjectAttributes (APP_CONTEXT_HANDLE dContext, pnstr8 dsName, pnstr8 *attrList, nint16 attrNum);

Description

The parameters are as follows:

dContext
(IN) Specifies the NDS context of the object. This must be a valid context.

dsName
(IN) Points to the typed name of the object.

attrList
(IN) Points to an array of pointers to strings that indicate which attributes to return. Set this to NULL to get all attributes (set attrNum to zero).

attrNum
(IN) Specifies the number of pointers in the attrList array. Set to 0 to return all attributes.

Return values

If successful, NWAPPGetObjectAttributes returns a pointer to the first node in a list of APP_OBJECT_ATTRIBUTE structures. Otherwise, it returns NULL.

Notices

NWAPPGetObjectAttributes returns a list of APP_OBJECT_ATTRIBUTE structures containing a list of APP_ATTRIBUTE_VALUES structures.

dsName is relative to dContext.

Call NWAPPFreeGetObjectAttributes to free the memory allocated by NWAPPGetObjectAttributes.

Services

NetWare Application Launcher (NAL) Services

References

APP_OBJECT_ATTRIBUTE, NWAPPFreeGetObjectAttributes(3nw),
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.