Directory Services

IADsNamespaces Property Methods

The IADsNamespaces interface property methods get and set the properties described in the following table. For more information, see Interface Property Methods.

Properties

Property Description
DefaultContainer

[Visual Basic]
Access: Read/Write
DataType: BSTR

[C++]
HRESULT get_DefaultContainer
([out] BSTR* pbstrDefault);
HRESULT put_DefaultContainer
([in] BSTR bstrDefault);

The DefaultContainer property identifies a base container object to which you can bind and use as a starting point when browsing. This data is stored and retrieved from the following registry value.

HKEY_CURRENT_USER
     Software
          Microsoft
               ADs
                    DefaultContainer

ADSI defines the DefaultContainer property to provide a quick way of getting a pointer to a previously defined ADSI container object.

Remarks

Providers must supply this property on a per-user basis. The default container is set immediately after the invocation of IADsNamespaces::put_DefaultContainer. Calling IADs.SetInfo is not required. In fact, the system-supplied namespaces object returns E_NOTIMPL for the IADs.SetInfo method called on this object. When a container is the namespaces object, an enumeration operation always results in a list of provider-specific namespace objects. When IADsContainer.GetObject is used to obtain a namespace object, the bstrClass parameter is ignored. This is because the container, that is, the namespaces object, contains only one type of object, namely, provider-specific namespace objects.

Requirements

Client: Included in Windows XP and Windows 2000 Professional.
Server: Included in Windows Server 2003 and Windows 2000 Server.
Redistributable: Requires Active Directory Client Extension on Windows NT 4.0 SP6a and Windows 95/98/Me.
Header: Declared in Iads.h.

See Also

IADsContainer.GetObject, IADsNamespaces, Interface Property Methods