NETAPI32.DLL/NETAPI32.LIB

by: mikefromrichmondPosted on 2003-06-19 at 07:58:39ID: 8758489

Do you mean information like this? http://msdn.microsoft.com/library/default.asp?url=/library/en-us/netmgmt/netmgmt/netusergetgroups.asp

I don't understand why you put this in the OS/2 category.

by: relfPosted on 2003-06-27 at 19:03:05ID: 8817424

rmani13, look at OS/2 Server Family Programming Reference (srvfpgr.inf) from OS/2 Toolkit. I quote related section below.

============
NetUserGetGroups or Net32UserGetGroups

The NetUserGetGroups API lists the names of all groups in the user accounts subsystem (UAS) database to which a
particular user belongs. For DSS, this list depends on the scope of the cell. See Scoping Rules for details on scoping
and the special OTHGRPS entry.

Users can use the NetUserGetGroups function on their user names.

The API returns the information in an array of group_info_0 data structures. This call is equivalent functionally to an
Enum call because it enumerates the groups of which a user is a member. For DSS, more than 254 groups may be
returned.

Restrictions

LAN Server and OS/2 Warp Server Only

This API can be called from DLS and OS/2 workstations, but only DLS workstations can issue this call to a
remote LAN Server workstation. DLS workstations can issue this call locally only if the Peer service is
started. User authority is allowed limited access to this API. Administrator authority is required for full
access.

Directory and Security Server Only

Any user can query the group membership list on any other user provided they have sufficient ACLs.

Syntax

#include <netcons.h>
#include <access.h>
#include <lsdceerr.h> /* DSS only */

NetUserGetGroups(pszTarget, pszUserID, usLevel,
buf, usBuflen,
pusEntriesReturned, pusEntriesAvail); /* 16 bit */

Net32UserGetGroups(pszTarget., pszUserID, ulLevel,
buf, ulBuflen,
pulEntriesReturned, pulEntriesAvail, pStatusbuf); /* 32 bit */

Parameters

See Common Parameter Definitions for descriptions of parameters not defined here.

pszUserID
(const unsigned char LSFAR *) points to the ASCIIZ string specifying the name of the user to
search for in each group account.

sLevel or ulLevel
(16-bit short or 32-bit unsigned long) must be 0, which specifies the data structure described in
Group Information Level 0.

Return Codes

The following table lists the return codes most significant to this API. (See API Return Codes for a complete
list of return codes.)

┌─────────────────────────────┬───────┬────────────────────────────────────────┐
│ SYMBOLIC CONSTANT │ VALUE │ MEANING │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_Success │ 0 │ No errors were encountered. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ ERROR_ACCESS_DENIED │ 5 │ Administrator privilege is required. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ ERROR_NOT_ENOUGH_MEMORY │ 8 │ Sufficient memory is not available. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ ERROR_NOT_SUPPORTED │ 50 │ This request is not supported by the │
│ │ │ network. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ ERROR_BAD_NETPATH │ 53 │ The network path cannot be found. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ ERROR_NETWORK_ACCESS_DENIED │ 65 │ Network access is denied. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ ERROR_INVALID_LEVEL │ 124 │ The ul/usLevel parameter is not valid. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ ERROR_MORE_DATA │ 234 │ Additional data is available, but the │
│ │ │ buffer is too small. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_NetNotStarted │ 2102 │ The redirector NETWKSTA.200 has not │
│ │ │ been started. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_RemoteOnly │ 2106 │ This operation is not supported on │
│ │ │ workstations. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_BufTooSmall │ 2123 │ The buffer is too small for fixed- │
│ │ │ length data. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_WkstaNotStarted │ 2138 │ The Requester service has not been │
│ │ │ started. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_InternalError │ 2140 │ An internal error has occurred. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_BadTransactConfig │ 2141 │ The server is not configured for │
│ │ │ transactions. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_UserNotFound │ 2221 │ The user name cannot be found. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_ACFNotLoaded │ 2227 │ The UAS database has not been started. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_ACFFileIOFail │ 2229 │ An error was encountered in accessing │
│ │ │ the accounts database. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_InvalidDatabase │ 2247 │ The UAS database file is damaged. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_InvalidComputer │ 2351 │ The specified computer name is not │
│ │ │ valid. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_DCEError │ 7500 │ DCE error status returned. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_DCEErrorLogged │ 7501 │ DCE error status has been logged. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_AuthTicketExpired │ 7511 │ The user's DCE authorization ticket │
│ │ │ has expired. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_RegistryNotFound │ 7512 │ Unable to contact the DCE security │
│ │ │ registry. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_UserNotInResdom │ 7513 │ The user is not a member of the speci- │
│ │ │ fied resource domain. │
└─────────────────────────────┴───────┴────────────────────────────────────────┘

Other codes could be returned from the following functions:

DosAllocSeg
DosChgFilePtr
DosFsCtl
DosGetShrSeg
DosNewSize
DosRead

Related Information

For information about retrieving the status of a user account, see User - NetUserGetInfo.

by: bapubaluPosted on 2003-08-05 at 03:24:40ID: 9079317

NetUserGetGroups

NET_API_STATUS NetUserGetGroups(
LPCWSTR servername,
LPCWSTR username,
DWORD level,
LPBYTE* bufptr,
DWORD prefmaxlen,
LPDWORD entriesread,
LPDWORD totalentries
);

Parameters
*********

servername - [in] Pointer to a constant string that specifies the DNS or NetBIOS name of the remote server on which the function is to execute. If this parameter is NULL, the local computer is used. Windows NT: This string must begin with \\.
username - [in] Pointer to a constant string that specifies the name of the user to search for in each group account. For more information, see the following Remarks section.
level - [in] Specifies the information level of the data. This parameter can be the following value.
bufptr - [out] Pointer to the buffer that receives the data. This buffer is allocated by the system and must be freed using the NetApiBufferFree function. Note that you must free the buffer even if the function fails with ERROR_MORE_DATA.
prefmaxlen - [in] Specifies the preferred maximum length of returned data, in bytes. If you specify MAX_PREFERRED_LENGTH, the function allocates the amount of memory required for the data. If you specify another value in this parameter, it can restrict the number of bytes that the function returns. If the buffer size is insufficient to hold all entries, the function returns ERROR_MORE_DATA.
entriesread - [out] Pointer to a value that receives the count of elements actually retrieved.
totalentries - [out] Pointer to a value that receives the total number of entries that could have been retrieved.

Return Values
***********
If the function succeeds, the return value is NERR_Success.

If the function fails, the return value can be one of the following error codes.

Return Code Description
ERROR_ACCESS_DENIED The user does not have access to the requested information.
ERROR_MORE_DATA More entries are available. Specify a large enough buffer to receive all entries.
NERR_InvalidComputer The computer name is invalid.
NERR_UserNotFound The user name could not be found.

by: rmani13Posted on 2003-11-03 at 13:46:07ID: 9674237

This question can be closed since it is open for a long time.

The question was to "find the arguments for the function NetUserGetGroups from the netapi32.lib/dll".
The answers given/pointed to were actually giving me the arguments of that function as given in the help.

To be more clear if I have a DLL or LIB, will I be able to find the arguments of a specific function in the DLL/LIB ?
Anyway Thanks for the responses.

by: rmani13Posted on 2003-11-03 at 13:55:49ID: 9674304

Can you tell me how to close it or I'm if you close it for me.

Thanks.

by: rmani13Posted on 2003-11-03 at 14:09:01ID: 9674391

I'm coming to a conclusion that there is no way one could find the arguments to a function from a DLL or LIB.

If no one objects this conlusion, this question can be closed.

Question

NETAPI32.DLL/NETAPI32.LIB

Subscribe now for full access to Experts Exchange and get

Instant Access to this Solution

Programming for OS / 2

Trusted by hundreds of thousands everyday for fast, accurate and reliable tech support.

See what Experts Exchange can do for you.

Got a question?

We've got the answer.

Need individual assistance?

Our experts are ready to help.

Want to learn from the best?

Read articles from industry experts.

Working on a long term project?

Store your work and research.

What Makes Experts Exchange Unique?

Trusted by the world's most respected brands.

Faithfully serving IT professionals since 1996.

Related Solutions

Free Tech Articles

Cloud Class Webinars

Join the Community

Give a Little. Get a Lot.

Answers

3 Ways to Join

The Experts

The Experts

Testimonials

Testimonials

Testimonials

Business Clients

Business Clients

In the Press

In the Press

In the Press