5.8 DCK_FLAGS Bit Values

The following table lists the bit values that the DCK_FLAGS key uses. They can be ORed together to specify the kinds of information the NWDSGetContext or NWDSSetContext functions set or retrieve. They are defined in the nwdsdc.h file.

Flag Name

C Value

Description

DCV_DEREF_ALIASES

0x00000001L

When set to one (1), deferences alias objects. This means that information about the object referenced by the alias, rather than alias object, is returned.

When set to zero (0), returns information about the Alias, rather than the object it references.

Default value: 1

DCV_XLATE_STRINGS

0x00000002L

When set to one (1), translates from Unicode strings to the local code page.

When set to zero (0), returns Unicode strings.

Array element size is byte for ASCII characters or double-byte for Unicode characters.

Default value: 1

DCV_TYPELESS_NAMES

0x00000004L

When set to one (1), returns typeless names.

When set to zero (0), returns typeful names.

Default value: 0

DCV_ASYNC_MODE

0x00000008L

Reserved.

DCV_CANONICALIZE_NAMES

0x00000010L

When set to one (1), the object name is appended to the name context value to form a distinguished name before sending a request to eDirectory. Partial names, relative to the name context, are returned.

When set to zero (0), no name manipulation is performed. Applications must send eDirectory distinguished names.

Default value: 1

DCV_DEREF_BASE_CLASS

0x00000040L

When set to one (1), returns the base class value of the object the alias references.

When set to zero (0), returns Alias as the base class of Alias objects.

This flag affects List, Read, and Search operations.

Default value: 0

DCV_DISALLOW_REFERRALS

0x00000080L

When set to one (1), referrals sent by eDirectory are not used and the current eDirectory agent must resolve the name.

Default value: 0

DCV_ALWAYS_EVALUATE_ REFERRALS

0x00000100L

When set to one (1), referrals are always requested and evaluated evein if the current eDirectory agent has a replica of the requested object. Applications can set this value to always attempt to communicate with the closest server.

Default value: 0