Another example of creating and adding a local group to Windows System



Compiler: Visual C++ Express Edition 2005

Compiled on Platform: Windows XP Pro SP2

Target platform: none, just for learning and fun

Header file: Standard and Windows

Additional library: Windows Platform SDK

Additional project setting: Set project to be compiled as C

Project -> your_project_name Properties -> Configuration Properties -> C/C++ -> Advanced -> Compiled As: Compiled as C Code (/TC)

Other info: non-CLR or unmanaged. Need to add netapi32.lib (netapi32.dll) to the project. Click the Project menu->Select the your_project_name Properties... sub menu->Expand the Configuration Properties folder on the left pane->Expand the Linker subfolder->Select the Input subfolder->Select the Additional Dependencies field on the right pane->Click the ... at the end of the field->Type in 'netapi32.lib' in the empty pane->Click the OK button->Click the OK button second time to close the project Properties dialog or use #pragma comment(lib, "netapi32.lib")

To do: Another example on how to add a local group to Windows system

To show: The Windows user management functions





//********* cplus.cpp **********

// For WinXp

#define _WIN32_WINNT 0x0501

// Wide character/Unicode based program

#ifndef UNICODE

#define UNICODE


#include <windows.h>

#include <stdio.h>

#include <lm.h>


// Creating a local group...

// This program accept 3 arguments: servername, GroupName and Comment.

int wmain(int argc, wchar_t *argv[])



DWORD dwLevel = 1;

DWORD dwError = 0;



if(argc != 4)


fwprintf(stderr, L"Usage: %s ServerName GroupName Comment\n", argv[0]);

fwprintf(stderr, L"Example: %s mypersonal AnotherLocalGroup \"Some comment for this local group\"\n", argv[0]);

// Just exit, no further processing




// Set up the LOCALGROUP_INFO_1 structure. Assign the group name and comment

lgi1.lgrpi1_name = argv[2]; // Local group name

lgi1.lgrpi1_comment = argv[3]; // Comment


// Call the NetLocalGroupAdd() function, specifying level 1.

nStatus = NetLocalGroupAdd(argv[1],





// If the call succeeds, inform the user.

if(nStatus == NERR_Success)

fwprintf(stderr, L"%s local group has been created successfully on %s machine.\n", argv[2], argv[1]);


// Otherwise, print the system error.


fprintf(stderr, "A system error has occurred: %d\n", nStatus);


return 0;



Output example:

 (This program run at the command prompt)



Usage: cplus ServerName GroupName Comment

Example: cplus mypersonal AnotherLocalGroup "Some comment for this local group"

F:\vc2005project\cplus\debug>cplus mypersonal AnotherLocalGroup "Just another local group"

AnotherLocalGroup local group has been created successfully on mypersonal machine.




Verify the local group creation as mentioned in the previous posts...



C and C++ Programming Resources | C & C++ Code Example Index