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

O método IADsPathname::Set configura o objeto Pathname para analisar um caminho de diretório. O caminho é definido com um formato conforme definido em ADS_SETTYPE_ENUM.

Sintaxe

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

Parâmetros

[in] bstrADsPath

Caminho de um objeto ADSI.

[in] lnSetType

Uma opção ADS_SETTYPE_ENUM que define o tipo de formato a ser recuperado.

Valor retornado

Esse método dá suporte aos valores retornados padrão, bem como o seguinte:

Para obter mais informações e outros valores retornados, consulte Códigos de erro ADSI.

Comentários

Esse método definirá o namespace conforme especificado e identificará o provedor apropriado para executar a operação de quebra de caminho. A redefinição para um namespace diferente perderá dados já definidos por esse método.

Exemplos

O exemplo de código do Visual Basic a seguir define um caminho ADSI completo no 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".

O exemplo de código VBScript/ASP a seguir define um caminho ADSI completo no 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".
%>

O exemplo de código C++ a seguir define um caminho ADSI completo no 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 com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Plataforma de Destino	Windows
Cabeçalho	iads.h
DLL	Activeds.dll

Confira também

Códigos de erro ADSI

ADS_SETTYPE_ENUM

IADsPathname