<div class="content" name="SamrOpenGroup" uuid="d396e6c9-d04a-4729-b0d8-f50f2748f3c8"><p>The SamrOpenGroup method obtains a handle to a group, given
a <span><a href="7b2aeb27-92fc-41f6-8437-deb65d950921#gt_df3d0b61-56cd-4dac-9402-982f1fedc41c" data-linktype="relative-path">RID</a></span>.</p><dl>
<dd>
<div><pre> long SamrOpenGroup(
   [in] SAMPR_HANDLE DomainHandle,
   [in] unsigned long DesiredAccess,
   [in] unsigned long GroupId,
   [out] SAMPR_HANDLE* GroupHandle
 );
</pre></div>
</dd></dl><p><b>DomainHandle: </b>An RPC context handle, as
specified in section <span><a href="8138c078-d881-4d1f-b378-94b4c34a287a" data-linktype="relative-path">2.2.7.2</a></span>,
representing a <span><a href="7b2aeb27-92fc-41f6-8437-deb65d950921#gt_2346e8d0-b0a0-481f-b644-85c45c60d4d1" data-linktype="relative-path">domain object</a></span>.</p><p><b>DesiredAccess: </b>An <span><a href="../ms-dtyp/7a53f60e-e730-4dfe-bbe9-b21b62eb790b" data-linktype="relative-path">ACCESS_MASK</a></span>
that indicates the requested access for the returned handle. See section <span><a href="f24f9fa8-798d-4e7d-a110-a5eda6900f41" data-linktype="relative-path">2.2.1.5</a></span>
for a list of group access values.</p><p><b>GroupId: </b>A RID of a group.</p><p><b>GroupHandle: </b>An RPC context handle, as
specified in section 2.2.7.2.</p><p>This protocol asks the RPC runtime, via the <b>strict_context_handle</b>
attribute, to reject the use of context handles created by a method of a
different RPC interface than this one, as specified in <span><a href="../ms-rpce/290c38b1-92fe-4229-91e6-4fc376610c15" data-linktype="relative-path">[MS-RPCE]</a></span>
section <span><a href="../ms-rpce/38ae9f5a-dac2-46ad-b2b7-9c43f211d9f6" data-linktype="relative-path">3</a></span>.</p><p>Upon receiving this message, the server MUST process the
data from the message according to the constraints in section <span><a href="fb25440b-269d-4220-99f2-8b29841cb1ce" data-linktype="relative-path">3.1.5.1.6</a></span>,
with the following values:</p><ul><li><p><span><span> 
</span></span> Target-Rid: <i>GroupId</i></p>
</li><li><p><span><span> 
</span></span>Target-Object-Type: a <span><a href="7b2aeb27-92fc-41f6-8437-deb65d950921#gt_7ce4771c-2043-49b8-85d3-0c60c7789f9a" data-linktype="relative-path">group object</a></span> (that
is, a database with the objectClass group or derived from group) and groupType
containing GROUP_TYPE_ACCOUNT_GROUP or GROUP_TYPE_UNIVERSAL_GROUP.</p>
</li><li><p><span><span> 
</span></span>Generic-Access-Mask-Mapping-Table:</p>
<table><thead>
  <tr>
   <th>
   <p>Incoming bit</p>
   </th>
   <th>
   <p>Translated bits</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>
  <p>GENERIC_READ</p>
  </td>
  <td>
  <p>GROUP_READ</p>
  </td>
 </tr><tr>
  <td>
  <p>GENERIC_WRITE</p>
  </td>
  <td>
  <p>GROUP_WRITE</p>
  </td>
 </tr><tr>
  <td>
  <p>GENERIC_EXECUTE</p>
  </td>
  <td>
  <p>GROUP_EXECUTE</p>
  </td>
 </tr><tr>
  <td>
  <p>GENERIC_ALL</p>
  </td>
  <td>
  <p>GROUP_ALL_ACCESS</p>
  </td>
 </tr></tbody></table>
</li><li><p><span><span> 
</span></span>Desired-Access-Mapping-Table:</p>
<table><thead>
  <tr>
   <th>
   <p>DesiredAccess</p>
   </th>
   <th>
   <p>Access mask</p>
   </th>
   <th>
   <p>Object ACE type</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>
  <p>GROUP_READ_INFORMATION</p>
  </td>
  <td>
  <p>ACTRL_DS_READ_PROP</p>
  </td>
  <td>
  <p>59ba2f42-79a2-11d0-9020-00c04fc2d3cf</p>
  </td>
 </tr><tr>
  <td>
  <p>GROUP_WRITE_ACCOUNT</p>
  </td>
  <td>
  <p>ACTRL_DS_WRITE_PROP</p>
  </td>
  <td>
  <p>59ba2f42-79a2-11d0-9020-00c04fc2d3cf</p>
  </td>
 </tr><tr>
  <td>
  <p>GROUP_ADD_MEMBER</p>
  </td>
  <td>
  <p>ACTRL_DS_WRITE_PROP</p>
  </td>
  <td>
  <p>bf9679c0-0de6-11d0-a285-00aa003049e2</p>
  </td>
 </tr><tr>
  <td>
  <p>GROUP_REMOVE_MEMBER</p>
  </td>
  <td>
  <p>ACTRL_DS_WRITE_PROP</p>
  </td>
  <td>
  <p>bf9679c0-0de6-11d0-a285-00aa003049e2</p>
  </td>
 </tr><tr>
  <td>
  <p>GROUP_LIST_MEMBERS</p>
  </td>
  <td>
  <p>ACTRL_DS_READ_PROP</p>
  </td>
  <td>
  <p>bf9679c0-0de6-11d0-a285-00aa003049e2</p>
  </td>
 </tr><tr>
  <td>
  <p>ACCESS_SYSTEM_SECURITY</p>
  </td>
  <td>
  <p>ACCESS_SYSTEM_SECURITY</p>
  </td>
  <td>
  <p> </p>
  </td>
 </tr><tr>
  <td>
  <p>WRITE_OWNER</p>
  </td>
  <td>
  <p>WRITE_OWNER</p>
  </td>
  <td>
  <p> </p>
  </td>
 </tr><tr>
  <td>
  <p>WRITE_DAC</p>
  </td>
  <td>
  <p>WRITE_DAC</p>
  </td>
  <td>
  <p> </p>
  </td>
 </tr><tr>
  <td>
  <p>DELETE</p>
  </td>
  <td>
  <p>DELETE</p>
  </td>
  <td>
  <p> </p>
  </td>
 </tr></tbody></table>
</li><li><p><span><span> 
</span></span>Output-Handle: <i>GroupHandle</i></p>
</li></ul></div>