2.2.21 LSAPR_TRANSLATED_NAME_EX

The LSAPR_TRANSLATED_NAME_EX structure contains information about a security principal along with the human-readable identifier for that security principal. This structure MUST always be accompanied by an LSAPR_REFERENCED_DOMAIN_LIST structure when DomainIndex is not -1, which contains the domain information for the security principals.

 typedef struct _LSAPR_TRANSLATED_NAME_EX {
   SID_NAME_USE Use;
   RPC_UNICODE_STRING Name;
   long DomainIndex;
   unsigned long Flags;
 } LSAPR_TRANSLATED_NAME_EX,
  *PLSAPR_TRANSLATED_NAME_EX;

Use: Defines the type of the security principal, as specified in section 2.2.13.

Name: Contains the name of the security principal. The RPC_UNICODE_STRING structure is defined in [MS-DTYP] section 2.3.10.

DomainIndex: Contains the index into the corresponding LSAPR_REFERENCED_DOMAIN_LIST structure that specifies the domain that the security principal is in. A DomainIndex value of -1 MUST be used to specify that there are no corresponding domains. Other negative values MUST NOT be used.

Flags: Contains bitmapped values that define the properties of this translation. The value MUST be the logical OR of zero or more of the following flags. These flags communicate the following additional information about how the SID was resolved.

Value

Meaning

0x00000001

The SID was not found by matching against the security principal SID property.

0x00000002

The SID might be found by traversing a forest trust.

0x00000004

The SID was found by matching against the last database view, defined in section 3.1.1.1.1.

All other bits MUST be 0 and ignored on receipt.<11>