home *** CD-ROM | disk | FTP | other *** search
/ Planet Source Code Jumbo …e CD Visual Basic 1 to 7 / 3_2004-2005.ISO / Data / Zips / AllAPI_API179141992004.psc / API / A / AllocateAndInitializeSid.api < prev    next >
Encoding:
INI File  |  2004-08-30  |  2.2 KB  |  55 lines
  1. [NAME]
  2. AllocateAndInitializeSid
  3. [DESCRIPTION]
  4. The AllocateAndInitializeSid function allocates and initializes a security identifier (SID) with up to eight subauthorities.
  5. [DECLARATION]
  6. Declare Function AllocateAndInitializeSid Lib "Advapi32" (pIdentifierAuthority As SID_IDENTIFIER_AUTHORITY, ByVal nSubAuthorityCount As Byte, ByVal nSubAuthority0 As Long, ByVal nSubAuthority1 As Long, ByVal nSubAuthority2 As Long, ByVal nSubAuthority3 As Long, ByVal nSubAuthority4 As Long, ByVal nSubAuthority5 As Long, ByVal nSubAuthority6 As Long, ByVal nSubAuthority7 As Long, lpPSid As Long) As Long
  7. [VBNET]
  8. N/A
  9. [OS]
  10. Requires Windows NT 3.1 or later; Win9x/ME: Not supported
  11. [LIBRARY]
  12. Advapi32
  13. [PARAMETERS]
  14. ╖ pIdentifierAuthority 
  15. [in] Pointer to a SID_IDENTIFIER_AUTHORITY structure, giving the top-level identifier authority value to set in the SID. 
  16.  
  17. ╖ nSubAuthorityCount 
  18. [in] 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 to 8. 
  19. 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. 
  20.  
  21. ╖ dwSubAuthority0 
  22. [in] Subauthority value to place in the SID. 
  23.  
  24. ╖ dwSubAuthority1 
  25. [in] Subauthority value to place in the SID. 
  26.  
  27. ╖ dwSubAuthority2 
  28. [in] Subauthority value to place in the SID. 
  29.  
  30. ╖ dwSubAuthority3 
  31. [in] Subauthority value to place in the SID. 
  32.  
  33. ╖ dwSubAuthority4 
  34. [in] Subauthority value to place in the SID. 
  35.  
  36. ╖ dwSubAuthority5 
  37. [in] Subauthority value to place in the SID. 
  38.  
  39. ╖ dwSubAuthority6 
  40. [in] Subauthority value to place in the SID. 
  41.  
  42. ╖ dwSubAuthority7 
  43. [in] Subauthority value to place in the SID. 
  44.  
  45. ╖ pSid 
  46. [out] Pointer to a variable that receives the pointer to the allocated and initialized SID structure.
  47. [RETURNS]
  48. If the function succeeds, the return value is nonzero.
  49.  
  50. If the function fails, the return value is zero. To get extended error information, call GetLastError.
  51. [EXAMPLES]
  52. Is Administrator*379F19E6D02F0E3CD66CD20D92C324AD.html
  53. [RELATED]
  54. FreeSid
  55.