|
Overview |
|
|
|
Group |
|
|
|
Quick Info
Windows NT
| Yes
| Win95
| No
| Win32s
| No
| Import Library
| advapi32.lib
| Header File
| winbase.h
| Unicode
| No
| Platform Notes
| None
|
|
|
AllocateAndInitializeSid
The AllocateAndInitializeSid function allocates and initializes a security identifier (SID) with up to
eight subauthorities.
BOOL AllocateAndInitializeSid(
PSID_IDENTIFIER_AUTHORITY pIdentifierAuthority,
| // pointer to identifier authority
| BYTE nSubAuthorityCount,
| // count of subauthorities
| DWORD dwSubAuthority0,
| // subauthority 0
| DWORD dwSubAuthority1,
| // subauthority 1
| DWORD dwSubAuthority2,
| // subauthority 2
| DWORD dwSubAuthority3,
| // subauthority 3
| DWORD dwSubAuthority4,
| // subauthority 4
| DWORD dwSubAuthority5,
| // subauthority 5
| DWORD dwSubAuthority6,
| // subauthority 6
| DWORD dwSubAuthority7,
| // subauthority 7
| PSID *pSid
| // pointer to pointer to SID
| );
|
|
Parameters
pIdentifierAuthority
Pointer to an SID_IDENTIFIER_AUTHORITY structure, giving the top-level identifier authority value to set in the SID.
nSubAuthorityCount
Specifies the number of subauthorities to place in the SID. This parameter
also identifies how many of the subauthority parameters have meaningful values.
This parameter must contain a value from 1 through 8.
For example, a value of 3 indicates that the subauthority values specified by
the dwSubAuthority0, dwSubAuthority1, and dwSubAuthority2 parameters have meaningful values and to ignore the remainder.
dwSubAuthority0 through dwSubAuthority7
Specify subauthority values to place in the SID.
pSid
Pointer to a variable that receives the pointer to the allocated and
initialized SID structure.
Return Values
If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero. To get extended error
information, call GetLastError.
Remarks
An SID allocated with the AllocateAndInitializeSid function must be freed by using the FreeSid function.
See Also
FreeSid, GetSidIdentifierAuthority, InitializeSid, SID_IDENTIFIER_AUTHORITY
Related Links
Software for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
TMS Scripter Studio Pro components for Delphi/C++Builder
More Online Helps
Win32 Multimedia Programmer's Reference (mmedia.hlp)
OLE Programmer's Reference (ole.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (tapi.hlp)
Unix Manual Pages
|
