IADsPathname::Set-Methode (iads.h)

Die IADsPathname::Set-Methode richtet das Pathname-Objekt zum Analysieren eines Verzeichnispfads ein. Der Pfad wird mit einem Format festgelegt, das in ADS_SETTYPE_ENUM definiert ist.

Syntax

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

Parameter

[in] bstrADsPath

Pfad eines ADSI-Objekts.

[in] lnSetType

Eine ADS_SETTYPE_ENUM Option, die den abzurufenden Formattyp definiert.

Rückgabewert

Diese Methode unterstützt die Standardrückgabewerte sowie Folgendes:

Weitere Informationen und andere Rückgabewerte finden Sie unter ADSI-Fehlercodes.

Hinweise

Diese Methode legt den Namespace wie angegeben fest und identifiziert den entsprechenden Anbieter für die Ausführung des Pfad crackvorgangs. Beim Zurücksetzen auf einen anderen Namespace gehen bereits von dieser Methode festgelegte Daten verloren.

Beispiele

Im folgenden Visual Basic-Codebeispiel wird ein vollständiger ADSI-Pfad für das Pathname-Objekt festgelegt.

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".

Im folgenden VBScript/ASP-Codebeispiel wird ein vollständiger ADSI-Pfad für das Pathname-Objekt festgelegt.

<%
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".
%>

Im folgenden C++-Codebeispiel wird ein vollständiger ADSI-Pfad für das Pathname-Objekt festgelegt.

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

Anforderungen

Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	iads.h
DLL	Activeds.dll

Weitere Informationen

ADSI-Fehlercodes

ADS_SETTYPE_ENUM

IADsPathname