Export (0) Print
Expand All

Active Directory Provider::Lookup Account From SID

Returns the account name and domain from a Active Directory directory service security identifier (SID). Used by Microsoft Provisioning Framework (MPF).

Lookup Account From SID is a wrapper for the Win32 functions ConvertStringSidToSid and LookupAccountSid.

The following table describes the XML schema elements and attributes. Unless otherwise indicated, the data type is string.

ElementDescription, relationships, and attributes

domain

Description:
Active Directory domain name.

Parent:
executeData

executeData

Description:
Encapsulates the procedure's input and output data.

Children:
domain (minOccurs="1" maxOccurs="1" output only)
name (minOccurs="1" maxOccurs="1", output only)
sid (minOccurs="1" maxOccurs="1", input only)
type (minOccurs="1" maxOccurs="1", output only)

name>

Description:
Account name.

Parent:
executeData

sid

Description:
String representing the account SID to look up.

Parent:
executeData

type

Description:
Account type (a decimal corresponding to the SID_NAME_USE enumeration).

SID_NAME_USE enumeration:

SidTypeUser1
SidTypeGroup2
SidTypeDomain3
SidTypeAlias4
SidTypeWellKnownGroup5
SidTypeDeletedAccount6
SidTypeInvalid7
SidTypeUnknown8
SidTypeComputer9

Parent:
executeData

If the procedure cannot find the SID, it returns 0x80070534, which means this action will fail with that HRESULT.

Input

 
<executeData>1..1
  <sid>1..1</sid>
</executeData>

Output

 
<executeData>1..1
  <name>1..1</name>
  <domain>1..1</domain>
  <type>1..1</type>
</executeData>

Example XML Request

The following code fragment shows the format for sending data to this procedure. For more information on individual elements and attributes, see the Elements and Attributes table.

Example XML Response

The following code fragment shows the format for data this procedure returns. For more information on individual elements and attributes, see the Elements and Attributes table.

Active Directory Provider for:

  • Hosted Messaging and Collaboration version 4.5

  • Hosted Messaging and Collaboration version 4.0

  • Hosted Messaging and Collaboration version 3.5

  • Hosted Messaging and Collaboration version 3.0

  • Windows-based Hosting version 4.5

  • Windows-based Hosting version 4.0

  • Windows-based Hosting version 3.5

  • Windows-based Hosting for Applications version 1.0

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft