Compartir a través de


Método IADsPathname::Set (iads.h)

El método IADsPathname::Set configura el objeto Pathname para analizar una ruta de acceso de directorio. La ruta de acceso se establece con un formato tal y como se define en ADS_SETTYPE_ENUM.

Sintaxis

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

Parámetros

[in] bstrADsPath

Ruta de acceso de un objeto ADSI.

[in] lnSetType

Opción ADS_SETTYPE_ENUM que define el tipo de formato que se va a recuperar.

Valor devuelto

Este método admite los valores devueltos estándar, así como los siguientes:

Para obtener más información y otros valores devueltos, consulta Códigos de error ADSI.

Comentarios

Este método establecerá el espacio de nombres como se especifica e identificará el proveedor adecuado para realizar la operación de descifrado de ruta de acceso. El restablecimiento en un espacio de nombres diferente perderá los datos ya establecidos por este método.

Ejemplos

En el siguiente ejemplo de código de Visual Basic se establece una ruta de acceso ADSI completa en el objeto Pathname.

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

El siguiente ejemplo de código VBScript/ASP establece una ruta de acceso ADSI completa en el objeto Pathname.

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

En el siguiente ejemplo de código de C++ se establece una ruta de acceso ADSI completa en el objeto Pathname.

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

Requisitos

   
Cliente mínimo compatible Windows Vista
Servidor mínimo compatible Windows Server 2008
Plataforma de destino Windows
Encabezado iads.h
Archivo DLL Activeds.dll

Consulte también

Códigos de error adsi

ADS_SETTYPE_ENUM

IADsPathname