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 |