3.1.5.5.4 SamrQueryInformationAlias (Opnum 28)

  • Article

The SamrQueryInformationAlias method obtains attributes from an alias object.

 long SamrQueryInformationAlias(
   [in] SAMPR_HANDLE AliasHandle,
   [in] ALIAS_INFORMATION_CLASS AliasInformationClass,
   [out, 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 return. See section 2.2.5.5 for a listing of possible values.

Buffer: The requested attributes on output. 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 appropriate output field name to the associated database attribute, as specified in section 3.1.5.14.10. Processing is completed by returning 0 on success. If the presented information level is not in the following table, the server MUST return an error.

    AliasInformationClass

    AliasGeneralInformation

    AliasNameInformation

    AliasAdminCommentInformation