3.1.5.6.3 SamrSetInformationAlias (Opnum 29)

  • Article

The SamrSetInformationAlias method updates attributes on an alias object.

 long SamrSetInformationAlias(
   [in] SAMPR_HANDLE AliasHandle,
   [in] ALIAS_INFORMATION_CLASS AliasInformationClass,
   [in, switch_is(AliasInformationClass)] 
     PSAMPR_ALIAS_INFO_BUFFER Buffer
 );

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

AliasInformationClass: An enumeration indicating which attributes to update. See section 2.2.5.5 for a listing of possible values.

Buffer: The requested attributes and values to update. See section 2.2.5.6 for structure details.

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. The following information levels MUST be processed by setting the database attribute on the alias object associated with AliasHandle.Object to the associated input field-name value using the mapping in section 3.1.5.14.10. All updates MUST be performed in the same transaction.

    AliasInformationClass

    AliasNameInformation

    AliasAdminInformation

  4. If AliasInformationClass does not meet the criteria of constraint 2, the server MUST return an error code.