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

O método IADsPathname::GetEscapedElement é usado para escapar de caracteres especiais no caminho de entrada.

Sintaxe

HRESULT GetEscapedElement(
  [in]  long lnReserved,
  [in]  BSTR bstrInStr,
  [out] BSTR *pbstrOutStr
);

Parâmetros

[in] lnReserved

Reservado para uso futuro.

[in] bstrInStr

Uma cadeia de caracteres de entrada.

[out] pbstrOutStr

Uma cadeia de caracteres de saída.

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 é usado para manipular um caminho que contém caracteres especiais em uma cadeia de caracteres sem escape como entrada de uma interface do usuário. A cadeia de caracteres de entrada deve ser um único elemento (par nome-valor) do caminho; ou seja, "CN=Smith, Jeff".

Exemplos

O exemplo de código do Visual Basic a seguir mostra o efeito produzido por IADsPathname::GetEscapedElement. Depois que esse código for executado, rdn conterá "cn=smith,jeff".

Dim x As New Pathname
 
rdn = x.GetEscapedElement(0, "cn=smith,jeff")

O exemplo de código VBScript a seguir mostra o efeito produzido por IADsPathname::GetEscapedElement. Depois que esse código for executado, rdn conterá "cn=smith,jeff".

Dim x 
Set x = CreateObject("Pathname")
rdn = x.GetEscapedElement(0, "cn=smith,jeff")

O exemplo de código C++ a seguir mostra o efeito produzido por IADsPathname::GetEscapedElement. Depois que esse código for executado, rdn conterá "cn=smith,jeff".

LPWSTR adsPath=L"LDAP://server/cn=jeffsmith,dc=Fabrikam,dc=com";
 
IADsPathname *pPath = GetPathnameObject(adsPath);
BSTR rdn;
HRESULT hr = pPath->GetEscapedElement(0,CComBSTR("cn=smith,jeff")
                                      ,&rdn);
 
pPath->Release();

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

IADsPathname