IADsPathname::Set method (iads.h)

The IADsPathname::Set method sets up the Pathname object for parsing a directory path. The path is set with a format as defined in ADS_SETTYPE_ENUM.

Syntax

HRESULT Set(
  BSTR bstrADsPath,
  long lnSetType
);

Parameters

bstrADsPath

Path of an ADSI object.

lnSetType

An ADS_SETTYPE_ENUM option that defines the format type to be retrieved.

Return value

This method supports the standard return values, as well as the following:

For more information and other return values, see ADSI Error Codes.

Remarks

This method will set the namespace as specified and identify the appropriate provider for performing the path cracking operation. Resetting to a different namespace will lose data already set by this method.

Examples

The following Visual Basic code example sets a full ADSI path on the Pathname object.

Dim x As New Pathname
 
x.Set "LDAP://server/CN=Jeff Smith, DC=Fabrikam, DC=Com", _
       ADS_SETTYPE_FULL
dn = x.GetElement(0)    ' dn now is "CN=Jeff Smith".

The following VBScript/ASP code example sets a full ADSI path on the Pathname object.

<%
Dim x
const ADS_SETTYPE_FULL = 1
Set x = CreateObject("Pathname")
path = "LDAP://server/CN=Jeff Smith, DC=Fabrikam,DC=com" 
x.Set path, ADS_SETTYPE_FULL
dn = x.GetElement(0)    ' dn now is "CN=Jeff Smith".
%>

The following C++ code example sets a full ADSI path on the Pathname object.

IADsPathname *pPathname=NULL;
HRESULT hr;
 
hr = CoCreateInstance(CLSID_Pathname,
                      NULL,
                      CLSCTX_INPROC_SERVER,
                      IID_IADsPathname,
                      (void**)&pPathname);
 
if(FAILED(hr)) 
{
    if(pPathname) pPathname->Release();
    return NULL;
}
 
hr = pPathname->Set(CComBSTR("LDAP://CN=pencil/desk"), 
                    ADS_SETTYPE_FULL);

Requirements

   
Minimum supported client Windows Vista
Minimum supported server Windows Server 2008
Target Platform Windows
Header iads.h
DLL Activeds.dll

See also

ADSI Error Codes

ADS_SETTYPE_ENUM

IADsPathname