IADsPathname：：Set 方法 (iads.h)

项目
08/24/2023

IADsPathname：：Set 方法设置用于分析目录路径的 Pathname 对象。路径使用 ADS_SETTYPE_ENUM 中定义的格式设置。

语法

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

parameters

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