4.1.2.1.2 DRS_MSG_ADDSIDREQ_V1

  • Article

The DRS_MSG_ADDSIDREQ_V1 structure defines the request message sent to the IDL_DRSAddSidHistory method.

 typedef struct {
   DWORD Flags;
   [string] WCHAR* SrcDomain;
   [string] WCHAR* SrcPrincipal;
   [string, ptr] WCHAR* SrcDomainController;
   [range(0,256)] DWORD SrcCredsUserLength;
   [size_is(SrcCredsUserLength)] WCHAR* SrcCredsUser;
   [range(0,256)] DWORD SrcCredsDomainLength;
   [size_is(SrcCredsDomainLength)] 
     WCHAR* SrcCredsDomain;
   [range(0,256)] DWORD SrcCredsPasswordLength;
   [size_is(SrcCredsPasswordLength)] 
     WCHAR* SrcCredsPassword;
   [string] WCHAR* DstDomain;
   [string] WCHAR* DstPrincipal;
 } DRS_MSG_ADDSIDREQ_V1;

Flags: A set of zero or more DRS_ADDSID_FLAGS bit flags.

SrcDomain: Name of the domain to query for the SID of SrcPrincipal. The domain name can be an FQDN (1) or a NetBIOS name.

SrcPrincipal: Name of a security principal (user, computer, or group) in the source domain. This is the source security principal, whose SIDs will be added to the destination security principal. If Flags contains DS_ADDSID_FLAG_PRIVATE_CHK_SECURE, this parameter is not used and is not validated. Otherwise, if Flags does not contain DS_ADDSID_FLAG_PRIVATE_DEL_SRC_OBJ, this name is a domain-relative Security Accounts Manager (SAM) name. Otherwise, it is a DN.

SrcDomainController: Name of the primary domain controller (PDC) (or PDC role owner) in the source domain. The DC name can be an Internet host name or a NetBIOS name. This parameter is only used when Flags contains neither DS_ADDSID_FLAG_PRIVATE_CHK_SECURE nor DS_ADDSID_FLAG_PRIVATE_DEL_SRC_OBJ. If Flags contains DS_ADDSID_FLAG_PRIVATE_DEL_SRC_OBJ, this parameter is not used, but it is validated.

SrcCredsUserLength: Count of characters in the SrcCredsUser array.

SrcCredsUser: User name for the credentials to be used in the source domain.

SrcCredsDomainLength: Count of characters in the SrcCredsDomain array.

SrcCredsDomain: Domain name for the credentials to be used in the source domain. The domain name can be an FQDN (1) or a NetBIOS domain name.

SrcCredsPasswordLength: Count of characters in the SrcCredsPassword array.

SrcCredsPassword: Password for the credentials to be used in the source domain.

DstDomain: Name of the destination domain in which DstPrincipal resides. The domain name can be an FQDN (1) or a NetBIOS name.

DstPrincipal: Name of a security principal (user, computer, or group) in the destination domain. This is the destination principal, to which the source principal's SIDs will be added. If Flags contains DS_ADDSID_FLAG_PRIVATE_CHK_SECURE, this parameter is not used and is not validated. Otherwise, if Flags does not contain DS_ADDSID_FLAG_PRIVATE_DEL_SRC_OBJ, this name is a domain-relative SAM name. Otherwise, it is a DN.