3.1.5.8.6 SamrGetMembersInAlias (Opnum 33)

  • Article

The SamrGetMembersInAlias method obtains the membership list of an alias.

 long SamrGetMembersInAlias(
   [in] SAMPR_HANDLE AliasHandle,
   [out] PSAMPR_PSID_ARRAY_OUT Members
 );

AliasHandle: An RPC context handle, as specified in section 2.2.7.2, representing an alias object.

Members: A structure containing an array of SIDs that represent the membership list of the alias referenced by AliasHandle.

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.

Upon 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 AliasHandle.HandleType is not equal to "Alias".

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

  3. On output, Members.Count MUST be equal to the number of values in the member attribute, and Members.Sids MUST have Member.Count number of elements. Each element MUST contain the objectSid value of the object referenced in the member attribute.