4.1.4.1.2 DRS_MSG_CRACKREQ_V1

The DRS_MSG_CRACKREQ_V1 structure defines the request message sent to the IDL_DRSCrackNames method.

 typedef struct {
   ULONG CodePage;
   ULONG LocaleId;
   DWORD dwFlags;
   DWORD formatOffered;
   DWORD formatDesired;
   [range(1,10000)] DWORD cNames;
   [string, size_is(cNames)] WCHAR** rpNames;
 } DRS_MSG_CRACKREQ_V1;

CodePage: The character set used by the client. This field SHOULD be ignored by the server.

LocaleId: The locale used by the client. This field SHOULD be ignored by the server.

dwFlags: Zero or more of the following bit flags, which are presented in little-endian byte order.

0	1	2	3	4	5	6	7	8	9	1 0	1	2	3	4	5	6	7	8	9	2 0	1	2	3	4	5	6	7	8	9	3 0	1
X	X	X	X	T R	G C	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	F P O	X	X	X	X	X	X	X

X: Unused. MUST be zero and ignored.

GC (DS_NAME_FLAG_GCVERIFY, 0x00000004): If set, the call fails if the server is not a GC server.

TR (DS_NAME_FLAG_TRUST_REFERRAL, 0x00000008): If set and the lookup fails on the server, referrals are returned to trusted forests where the lookup might succeed.

FPO (DS_NAME_FLAG_PRIVATE_RESOLVE_FPOS, 0x80000000): If set and the named object is a foreign security principal, indicate this by using the status of the lookup operation.

formatOffered: The format of the names in rpNames. This can be one of the values from DS_NAME_FORMAT (section 4.1.4.1.3) or one of the following.

Value	Meaning
DS_LIST_SITES 0xFFFFFFFF	Get all sites in the forest.
DS_LIST_SERVERS_IN_SITE 0xFFFFFFFE	Get all servers in a given site.
DS_LIST_DOMAINS_IN_SITE 0xFFFFFFFD	Get all domains in a given site.
DS_LIST_SERVERS_FOR_DOMAIN_IN_SITE 0xFFFFFFFC	Get all DCs of a specified domain in a given site.
DS_LIST_INFO_FOR_SERVER 0xFFFFFFFB	Get DNS host name and server reference for a given DC.
DS_LIST_ROLES 0xFFFFFFFA	Get FSMO role owners.
DS_NT4_ACCOUNT_NAME_SANS_DOMAIN 0xFFFFFFF9	Get value of sAMAccountName attribute.
DS_MAP_SCHEMA_GUID 0xFFFFFFF8	Get LDAP display name from schema GUID. The given schema GUID must be in the curly braced GUID string format as specified in [MS-DTYP] section 2.3.4.3.
DS_LIST_DOMAINS 0xFFFFFFF7	Get all domains in the forest.
DS_LIST_NCS 0xFFFFFFF6	Get all NCs in the forest.
DS_ALT_SECURITY_IDENTITIES_NAME 0xFFFFFFF5	Compares input names against the values of the altSecurityIdentities attribute.
DS_STRING_SID_NAME 0xFFFFFFF4	String form of SID.
DS_LIST_SERVERS_WITH_DCS_IN_SITE 0xFFFFFFF3	Get all DCs in a given site.
DS_LIST_GLOBAL_CATALOG_SERVERS 0xFFFFFFF1	Get all GCs in the forest.
DS_NT4_ACCOUNT_NAME_SANS_DOMAIN_EX 0xFFFFFFF0	Get value of sAMAccountName attribute; return status DS_NAME_ERROR_NOT_FOUND if account is invalid.
DS_USER_PRINCIPAL_NAME_AND_ALTSECID 0xFFFFFFEF	Compares input names against the user principal name and the values of the altSecurityIdentities attribute.

formatDesired: Format of the names in the rItems field of the DS_NAME_RESULTW structure, which is returned inside the DRS_MSG_CRACKREPLY message. This can be one of the values from DS_NAME_FORMAT or one of the following.

Value	Meaning
DS_STRING_SID_NAME 0xFFFFFFF4	String form of a SID.
DS_USER_PRINCIPAL_NAME_FOR_LOGON 0xFFFFFFF2	User principal name.

cNames: Count of items in the rpNames array.

rpNames: Input names to translate.