Método IADsPathname::GetEscapedElement (iads.h)
El método IADsPathname::GetEscapedElement se usa para escapar caracteres especiales en la ruta de acceso de entrada.
Sintaxis
HRESULT GetEscapedElement(
[in] long lnReserved,
[in] BSTR bstrInStr,
[out] BSTR *pbstrOutStr
);
Parámetros
[in] lnReserved
Reservado para uso futuro.
[in] bstrInStr
Cadena de entrada.
[out] pbstrOutStr
Cadena de salida.
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 se usa para controlar una ruta de acceso que contiene caracteres especiales en una cadena sin escape como entrada de una interfaz de usuario. La cadena de entrada debe ser un único elemento (par nombre-valor) de la ruta de acceso; es decir, "CN=Smith, Jeff".
Ejemplos
En el siguiente ejemplo de código de Visual Basic se muestra el efecto generado por IADsPathname::GetEscapedElement. Una vez ejecutado este código, rdn contendrá "cn=smith,jeff".
Dim x As New Pathname
rdn = x.GetEscapedElement(0, "cn=smith,jeff")
En el siguiente ejemplo de código de VBScript se muestra el efecto generado por IADsPathname::GetEscapedElement. Una vez ejecutado este código, rdn contendrá "cn=smith,jeff".
Dim x
Set x = CreateObject("Pathname")
rdn = x.GetEscapedElement(0, "cn=smith,jeff")
En el siguiente ejemplo de código de C++ se muestra el efecto generado por IADsPathname::GetEscapedElement. Una vez ejecutado este código, rdn contendrá "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 compatible | Windows Vista |
| Servidor mínimo compatible | Windows Server 2008 |
| Plataforma de destino | Windows |
| Encabezado | iads.h |
| Archivo DLL | Activeds.dll |