Returns information about a group.
wntGroupInfo(server-name, group, group-type, request[, output-format-flag[, input-format-flag]])
(s) server-name: the UNC name of the server on which the function will execute (eg, "\\MYSERVER"), or "" for the local computer.
(s) group name: of a group.
(s) group-type: can be @LOCALGROUP or @GLOBALGROUP.
(s) request: specifies the information to be returned, (see below).
(i) output-format-flag: [optional] controls the format of the group name that is returned when 'Request' is specified.
|
Value |
Meaning |
|
1 |
group names will have domain names prefixed on to them,except in cases where the domain name is "BUILTIN" or "NT AUTHORITY". |
|
2 |
group names will have domain names prefixed on to them in all cases. |
|
4 |
a SID value will be returned in place of a group name. |
(i) input-format-flag: [optional] controls how the group-name parameter value is interpreted.
|
Value |
Meaning |
|
0 |
(default) actual group account name. |
|
1 |
group-name parameter contains a SID value instead of an actual group account name. |
(s) Returns a string.
"request" specifies the information to be returned, and can be one of the following:
|
request |
type |
description |
|
-1 |
(i) |
@TRUE if group exists, @FALSE if it doesn't. |
|
0 |
(s) |
group name |
|
1 |
(s) |
group comment |
|
2 |
(i) |
group's RID (relative identifier) |
; Load Appropriate Extender AddExtender('wwwnt34i.dll',0,'wwwnt64i.dll')
comment = wntGroupInfo("", "Administrators", @LOCALGROUP, 1, 1, 0) Message("Comment for 'Administrators'", comment) Exit