IADsPathname：：Set 方法 (iads.h)

發行項
08/24/2023

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