4.1.4.2.16 LookupUnknownName

  • 2 minutes to read

 procedure LookupUnknownName(
   flags: DWORD,
   name: unicodestring,
   formatDesired: DWORD): DS_NAME_RESULT_ITEMW

Informative summary of behavior: The server uses LookupUnknownName to look up names of format DS_UNKNOWN_NAME. LookupUnknownName looks up the name by trying formats in the specific order listed in the foreach statement shown below until a lookup succeeds and produces the output name in the given output format.

  
 result: DS_NAME_RESULT_ITEMW
 format: DWORD
  
  
 /* Attempt to resolve in the following formats in this specific
  * order. */
 foreach format in {DS_FQDN_1779_NAME, DS_USER_PRINCIPAL_NAME,
                    DS_NT4_ACCOUNT_NAME, DS_CANONICAL_NAME,
                    DS_UNIQUE_ID_NAME, DS_DISPLAY_NAME,
                    DS_SERVICE_PRINCIPAL_NAME,
                    DS_SID_OR_SID_HISTORY_NAME,
                    DS_CANONICAL_NAME_EX}
   result := LookupName(flags, format, formatDesired, name)
   if result.status ≠ DS_NAME_ERROR_NOT_FOUND then
     return result
   endif
 endfor
 return result