IADsPathname::Set メソッド (iads.h)

  • [アーティクル]

IADsPathname::Set メソッドは、ディレクトリ パスを解析するための Pathname オブジェクトを設定します。 パスは、 ADS_SETTYPE_ENUMで定義されている形式で設定されます。

構文

HRESULT Set(
  [in] BSTR bstrADsPath,
  [in] long lnSetType
);

パラメーター

[in] bstrADsPath

ADSI オブジェクトのパス。

[in] lnSetType

取得する書式の種類を定義する ADS_SETTYPE_ENUM オプション。

戻り値

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

詳細およびその他の戻り値については、「 ADSI エラー コード」を参照してください。

解説

このメソッドは、指定された名前空間を設定し、パスクラッキング操作を実行するための適切なプロバイダーを識別します。 別の名前空間にリセットすると、このメソッドによって既に設定されているデータが失われます。

例

次の 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 now is "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 now is "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);

要件

   
サポートされている最小のクライアント Windows Vista
サポートされている最小のサーバー Windows Server 2008
対象プラットフォーム Windows
ヘッダー iads.h
[DLL] Activeds.dll

関連項目

ADSI エラー コード

ADS_SETTYPE_ENUM

IADsPathname