Active Directory Provider::Evaluate

Active Directory Provider::Evaluate

Evaluates a simple expression and returns a regular expression. For example, you can use it to build and modify the values for an object's userAccountControl property. Used by Microsoft® Provisioning Framework (MPF).

XML Input Schema
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.
<executeData>1..1
  <expression>1..1
	
	<value>1..1</value>
	<hex>1..1</hex>
	<rand>1..1</rand>
	<enum>1..1</enum>
	<or>1..1</or>
	<and>1..1</and>
	<not>1..1</not>
	<mod>1..1</mod>
  </expression>
</executeData>
XML Output Schema
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.
<executeData>1..1
  <result>1..1</result>
</executeData>
Elements and Attributes

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

Element Description, relationships, and attributes

and Description:
Bitwise AND operator. Operands are converted to a VARIANT of type VT_I4. The result is a VARIANT of type VT_I4.
Parents:
and, expression, mod, not, or

Children:
Must be exactly two of the following elements.
and (minOccurs="1" maxOccurs="1", input only)
enum (minOccurs="1" maxOccurs="1", input only)
hex (minOccurs="1" maxOccurs="1", input only)
mod (minOccurs="1" maxOccurs="1", input only)
not (minOccurs="1" maxOccurs="1", input only)
or (minOccurs="1" maxOccurs="1", input only)
rand (minOccurs="1" maxOccurs="1", input only)

enum Description:
Enumeration string for manipulating Microsoft® Active Directory® user properties. This element accepts the following ADS_USER_FLAG_ENUM strings as input values.

ADS_UF_SCRIPT 0x0001

ADS_UF_ACCOUNTDISABLE 0x0002

ADS_UF_HOMEDIR_REQUIRED 0x0008

ADS_UF_LOCKOUT 0x0010

ADS_UF_PASSWD_NOTREQD 0x0020

ADS_UF_PASSWD_CANT_CHANGE 0x0040

ADS_UF_ENCRYPTED_TEXT_PASSWORD_ALLOWED 0x0080

ADS_UF_TEMP_DUPLICATE_ACCOUNT 0x0100

ADS_UF_NORMAL_ACCOUNT 0x0200

ADS_UF_INTERDOMAIN_TRUST_ACCOUNT 0x0800

ADS_UF_WORKSTATION_TRUST_ACCOUNT 0x1000

ADS_UF_SERVER_TRUST_ACCOUNT 0x2000

ADS_UF_DONT_EXPIRE_PASSWD 0x10000

ADS_UF_MNS_LOGON_ACCOUNT 0x20000

ADS_UF_SMARTCARD_REQUIRED 0x40000

ADS_UF_TRUSTED_FOR_DELEGATION 0x80000

ADS_UF_NOT_DELEGATED 0x100000

Parents:
and, expression, mod, not, or

executeData Description:
Encapsulates the procedure's input and output data.
Children:
expression (minOccurs="1" maxOccurs="1", input only)
result (minOccurs="1" maxOccurs="1", output only)

expression Description:
Expression to evaluate.
Parent:
executeData

Children:
Must be exactly one of the following elements.
and (minOccurs="1" maxOccurs="1", input only)
enum (minOccurs="1" maxOccurs="1", input only)
hex (minOccurs="1" maxOccurs="1", input only)
mod (minOccurs="1" maxOccurs="1", input only)
not (minOccurs="1" maxOccurs="1", input only)
or (minOccurs="1" maxOccurs="1", input only)
rand (minOccurs="1" maxOccurs="1", input only)

hex Description:
A literal hex value interpreted as a hex number. The result is a VARIANT of type VT_I4.
Note Do not include "0x" or "&H".

Parents:
and, expression, mod, not, or

mod Description:
Remainder (modulus) of the first subelement divided by the second subelement.
Parents:
and, expression, mod, not, or

Children:
Must be exactly two of the following elements.
and (minOccurs="1" maxOccurs="1", input only)
enum (minOccurs="1" maxOccurs="1", input only)
hex (minOccurs="1" maxOccurs="1", input only)
mod (minOccurs="1" maxOccurs="1", input only)
not (minOccurs="1" maxOccurs="1", input only)
or (minOccurs="1" maxOccurs="1", input only)
rand (minOccurs="1" maxOccurs="1", input only)

not Description:
Bitwise NOT operator. The operand is converted to a VARIANT of type VT_I4. The result is a VARIANT of type VT_I4.
Parents:
and, expression, mod, not, or

Children:
Must be exactly two of the following elements.
and (minOccurs="1" maxOccurs="1", input only)
enum (minOccurs="1" maxOccurs="1", input only)
hex (minOccurs="1" maxOccurs="1", input only)
mod (minOccurs="1" maxOccurs="1", input only)
not (minOccurs="1" maxOccurs="1", input only)
or (minOccurs="1" maxOccurs="1", input only)
rand (minOccurs="1" maxOccurs="1", input only)

or Description:
Bitwise OR operator. Operands are converted to a VARIANT of type VT_I4. The result is a VARIANT of type VT_I4.
Parents:
and, expression, mod, not, or

Children:
Must be exactly two of the following elements.
and (minOccurs="1" maxOccurs="1", input only)
enum (minOccurs="1" maxOccurs="1", input only)
hex (minOccurs="1" maxOccurs="1", input only)
mod (minOccurs="1" maxOccurs="1", input only)
not (minOccurs="1" maxOccurs="1", input only)
or (minOccurs="1" maxOccurs="1", input only)
rand (minOccurs="1" maxOccurs="1", input only)

rand Description:
Returns a random number from 0 to 32767 as a VARIANT of type VT_I2. Randomize is performed at the start of the first use.
Parents:
and, expression, mod, not, or

result Description:
Returns the computed result value of the expression.

Parent:
executeData

value Description:
A literal value. By default, it is interpreted as a string. The result is type VT_BSTR.
Parents:
and, expression, mod, not, or

Remarks

Numbers passed in to this procedure are assumed to be decimal.

See Also

Active Directory Provider

Top of Page
© 1999-2002 Microsoft Corporation. All rights reserved.