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 |