IADsPathname interface (iads.h)

The IADsPathname interface parses the X.500 and Windows path in ADSI.

The IADsPathname interface can be used to:

• Set and get paths of ADSI objects in different formats.
• Extract or add each element for a given ADsPath.
• Construct ADsPaths to be used in queries of directory objects.

The IADsPathname interface is implemented on a Pathname object. You must instantiate the Pathname object to use the methods defined in the IADsPathname interface. This requirement is similar to calling the CoCreateInstance() function in C++.

IADsPathname *pPathname=NULL;
HRESULT hr;
 
hr = CoCreateInstance(CLSID_Pathname,
                      NULL,
                      CLSCTX_INPROC_SERVER,
                      IID_IADsPathname,
                      (void**)&pPathname);

You can also invoke the New operator in Visual Basic:

Dim path As New Pathname

Or use the CreateObject function in VBScript, supplying "Pathname" as the ProgID.

Dim path
Set path = CreateObject("Pathname")

The IADsPathname interface uses two enumeration types: ADS_SETTYPE_ENUM, and ADS_FORMAT_ENUM.

Inheritance

The IADsPathname interface inherits from the IDispatch interface. IADsPathname also has these types of members:

Methods

The IADsPathname interface has these methods.

IADsPathname::AddLeafElement Adds an element to the end of the directory path already set on the Pathname object.
IADsPathname::CopyPath Creates a copy of the Pathname object.
IADsPathname::GetElement Retrieves an element of a directory path.
IADsPathname::GetEscapedElement Used to escape special characters in the input path.
IADsPathname::GetNumElements Retrieves the number of elements in the path.
IADsPathname::RemoveLeafElement Removes the last element from the directory path that has been set on the Pathname object.
IADsPathname::Retrieve The IADsPathname::Retrieve method retrieves the path of the object with different format types.
IADsPathname::Set Sets up the Pathname object for parsing a directory path.
IADsPathname::SetDisplayType Specifies how to display the path of an object.

Requirements

Requirement	Value
Minimum supported client	Windows Vista
Minimum supported server	Windows Server 2008
Target Platform	Windows
Header	iads.h

See also

ADS_FORMAT_ENUM

ADS_SETTYPE_ENUM

CoCreateInstance()

IADsPathname Property Methods

IDispatch