Export (0) Print
Expand All

3.1.5.13.2 SamrSetMemberAttributesOfGroup (Opnum 26)

The SamrSetMemberAttributesOfGroup method sets the attributes of a member relationship.

long SamrSetMemberAttributesOfGroup(
  [in] SAMPR_HANDLE GroupHandle,
  [in] unsigned long MemberId,
  [in] unsigned long Attributes
);

GroupHandle: An RPC context handle, as specified in section 2.2.3.2, representing a group object.

MemberId: A RID that represents a member of a group (which is a user or machine account).

Attributes: The characteristics of the membership relationship. For legal values, see section 2.2.1.10.

This protocol asks the RPC runtime, via the strict_context_handle attribute, to reject the use of context handles created by a method of a different RPC interface than this one, as specified in [MS-RPCE] section 3.

On receiving this message, the server MUST process the data from the message subject to the following constraints:

  1. The server MUST return an error if GroupHandle.HandleType is not equal to "Group".

  2. GroupHandle.GrantedAccess MUST have the required access specified in section 3.1.2.1. Otherwise, the server MUST return STATUS_ACCESS_DENIED.

  3. In a non-DC configuration, the MemberId parameter MUST be a member of the group referenced by GroupHandle.Object; otherwise, processing MUST be aborted and an error returned.

  4. For a message processing specification of the Attributes parameter, see section 3.1.5.14.7.

 
Show:
© 2014 Microsoft