please dont rip this site Prev Next

GetAccessPermissionsForObject info  Overview  Group

[This is a preview of an interface that may appear in future releases of Windows.]

The GetAccessPermissionsForObject function determines the access rights supported by a specified object.

DWORD GetAccessPermissionsForObject(

    LPCTSTR lpObject,

// name of the object

    SE_OBJECT_TYPE ObjectType,

// type of object

    LPCTSTR lpProvider,

// name of provider to handle request

    PULONG pcEntries,

// receives number of entries in the array

    PACTRL_ACCESS_INFO *ppAccessInfoList,

// receives an array of access information

    PULONG pfAccessFlags

// receives access flags



Pointer to a null-terminated string that specifies the name of the object for which to get the list of supported access rights. For descriptions of the string formats for the different object types, see SE_OBJECT_TYPE.
Specifies a value from the SE_OBJECT_TYPE enumeration that indicates the type of object named by the lpObject parameter.
Pointer to a null-terminated string that specifies the name of the provider to handle the request. If this parameter is NULL, the system determines the proper provider to handle the request.
Pointer to a ULONG value that receives the number of entries returned in the ppAccessInfoList array.
Pointer to a variable that receives a pointer to an array of ACTRL_ACCESS_INFO structures. Each entry identifies an access right supported by the object. Call the LocalFree function to free the returned buffer.
Pointer to a ULONG value that can receive the following access flag.




The object's provider supports setting access-control entries on the object's properties, and it also supports propagating inherited entries to child objects.

Return Values

If the function succeeds, the return value is ERROR_SUCCESS.

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




The lpProvider parameter specified an invalid provider name.


An invalid parameter was specified.


A memory allocation failed.


The GetAccessPermissionsForObject function returns an array of ACTRL_ACCESS_INFO structures to indicate the access rights an object supports. For example, the array for an SE_FILE_OBJECT object type might include the following access rights and string descriptions.
{ACTRL_SYNCHRONIZE, “Synchronize”},

{ACTRL_CHANGE_OWNER, “Change Owner”},

{ACTRL_CHANGE_ACCESS, “Change Access”},


{ACTRL_FILE_READ, “Read File”},

{ACTRL_FILE_WRITE, “Write File”}


Currently, the import library for the GetAccessPermissionsForObject function is ACCSRC.LIB. This is temporary. Eventually, the import library will be ADVAPI32.LIB. Meanwhile, any source code that links with the ACCSRC.LIB library must call the AccProvInit macro as follows:

    DWORD dwErrcode;


    if(dwErrcode != ERROR_SUCCESS)


         // Consider this an error...



See Also


file: /Techref/os/win/api/win32/func/src/f26_17.htm, 6KB, , updated: 2000/4/7 12:19, local time: 2024/5/18 18:06,

 ©2024 These pages are served without commercial sponsorship. (No popup ads, etc...).Bandwidth abuse increases hosting cost forcing sponsorship or shutdown. This server aggressively defends against automated copying for any reason including offline viewing, duplication, etc... Please respect this requirement and DO NOT RIP THIS SITE. Questions?
Please DO link to this page! Digg it! / MAKE!

<A HREF=""> GetAccessPermissionsForObject</A>

After you find an appropriate page, you are invited to your to this massmind site! (posts will be visible only to you before review) Just type a nice message (short messages are blocked as spam) in the box and press the Post button. (HTML welcomed, but not the <A tag: Instead, use the link box to link to another page. A tutorial is available Members can login to post directly, become page editors, and be credited for their posts.

Link? Put it here: 
if you want a response, please enter your email address: 
Attn spammers: All posts are reviewed before being made visible to anyone other than the poster.
Did you find what you needed?


Welcome to!


Welcome to!