IADsPathname

ADSI における X.500 および Windows パスを解析します。

ディレクトリパスを解析するために Pathname オブジェクトを設定します。

このメソッドは、標準の戻り値に加えて次の値をサポートします。

詳細およびその他の戻り値については、ADSI Error Codes を参照してください。

このメソッドは、指定されたとおりに名前空間を設定し、パスの解析操作を実行するための適切なプロバイダーを特定します。別の名前空間に再設定すると、このメソッドで既に設定されたデータは失われます。

例

次の Visual Basic のコード例は、Pathname オブジェクトに完全な ADSI パスを設定します。

Dim x As New Pathname
 
x.Set "LDAP://server/CN=Jeff Smith, DC=Fabrikam, DC=Com", _
       ADS_SETTYPE_FULL
dn = x.GetElement(0)    ' dn は "CN=Jeff Smith" になります。

次の VBScript/ASP のコード例は、Pathname オブジェクトに完全な ADSI パスを設定します。

<%
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 は "CN=Jeff Smith" になります。
%>

次の C++ のコード例は、Pathname オブジェクトに完全な ADSI パスを設定します。

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);

オブジェクトのパスの表示方法を指定します。

このメソッドは、標準の戻り値に加えて次の値をサポートします。

IADsPathname::Retrieve メソッドは、さまざまな形式の種類でオブジェクトのパスを取得します。

このメソッドは、標準の戻り値に加えて次の値をサポートします。

詳細およびその他の戻り値については、ADSI Error Codes を参照してください。

パス内の要素の数を取得します。

このメソッドは、標準の戻り値に加えて次の値をサポートします。

詳細およびその他の戻り値については、ADSI Error Codes を参照してください。

ディレクトリパスの要素を取得します。

このメソッドは、標準の戻り値に加えて次の値をサポートします。

詳細およびその他の戻り値については、ADSI Error Codes を参照してください。

Pathname オブジェクトに既に設定されているディレクトリパスの末尾に要素を追加します。

このメソッドは、標準の戻り値に加えて次の値をサポートします。

詳細およびその他の戻り値については、ADSI Error Codes を参照してください。

Pathname オブジェクトに設定されているディレクトリパスから最後の要素を削除します。

このメソッドは、標準の戻り値に加えて次の値をサポートします。

詳細およびその他の戻り値については、ADSI Error Codes を参照してください。

Pathname オブジェクトのコピーを作成します。

このメソッドは、標準の戻り値に加えて次の値をサポートします。

詳細およびその他の戻り値については、ADSI Error Codes を参照してください。

このメソッドは、オブジェクトのパスを変更しつつ、元のオブジェクトのパスを保持するために使用します。

例

次の Visual Basic のコード例は、パス名のコピーを作成する方法を示します。

Dim x, y As New Pathname
x.Set "LDAP://srv1/dc=dom,dc=company,dc=com",ADS_SETTYPE_FULL
set y = x.CopyPath
MsgBox y.Retrieve(ADS_FORMAT_WINDOWS)

次の VBScript/ASP のコード例は、パス名のコピーを作成する方法を示します。

<%
Dim x, y
Const ADS_SETTYPE_FULL = 1
Const ADS_FORMAT_WINDOWS = 1
Set x = CreateObject("Pathname")
x.Set "LDAP://srv1/dc=dom,dc=company,dc=com",ADS_SETTYPE_FULL
 
set y = x.CopyPath
Response.Write y.Retrieve(ADS_FORMAT_WINDOWS)
%>

次の C++ のコード例は、パス名オブジェクトのコピーを作成します。GetPathnameObject 関数の詳細およびコード例については、IADsPathname を参照してください。

IADsPathname *pPath;
LPWSTR adsPath;
adsPath = L"LDAP://server/cn=jeff smith,dc=Fabrikam,dc=com";
 
IADsPathname *pPath = GetPathnameObject(adsPath)
if (!pPath) exit(0);
 
IDispatch *pDisp;
HRESULT hr;
hr = pPath->CopyPath(&pDisp);
if(FAILED(hr)) exit(hr);
 
IADsPathname *pPathCopy;
hr = pDisp->QueryInterface(IID_IADsPathname,(void**)&pPathCopy);
 
// ...

入力パス内の特殊文字をエスケープするために使用します。

このメソッドは、標準の戻り値に加えて次の値をサポートします。

詳細およびその他の戻り値については、ADSI Error Codes を参照してください。

このメソッドは、ユーザーインターフェイスからの入力として、エスケープされていない文字列に特殊文字を含むパスを処理するために使用します。入力文字列は、パスの単一の要素(名前と値のペア)である必要があります。つまり "CN=Smith,Jeff" のような形式です。

例

次の Visual Basic のコード例は、IADsPathname::GetEscapedElement によって生じる効果を示します。このコードを実行すると、rdn には "cn=smith,jeff" が格納されます。

Dim x As New Pathname
 
rdn = x.GetEscapedElement(0, "cn=smith,jeff")

次の VBScript のコード例は、IADsPathname::GetEscapedElement によって生じる効果を示します。このコードを実行すると、rdn には "cn=smith,jeff" が格納されます。

Dim x 
Set x = CreateObject("Pathname")
rdn = x.GetEscapedElement(0, "cn=smith,jeff")

次の C++ のコード例は、IADsPathname::GetEscapedElement によって生じる効果を示します。このコードを実行すると、rdn には "cn=smith,jeff" が格納されます。

LPWSTR adsPath=L"LDAP://server/cn=jeffsmith,dc=Fabrikam,dc=com";
 
IADsPathname *pPath = GetPathnameObject(adsPath);
BSTR rdn;
HRESULT hr = pPath->GetEscapedElement(0,CComBSTR("cn=smith,jeff")
                                      ,&rdn);
 
pPath->Release();