IADsPathname::GetEscapedElement, méthode (iads.h)
La méthode IADsPathname::GetEscapedElement est utilisée pour échapper des caractères spéciaux dans le chemin d’entrée.
Syntaxe
HRESULT GetEscapedElement(
[in] long lnReserved,
[in] BSTR bstrInStr,
[out] BSTR *pbstrOutStr
);
Paramètres
[in] lnReserved
Réservé pour un usage futur.
[in] bstrInStr
Chaîne d’entrée.
[out] pbstrOutStr
Chaîne de sortie.
Valeur retournée
Cette méthode prend en charge les valeurs de retour standard, ainsi que les éléments suivants :
Pour plus d’informations et d’autres valeurs de retour, consultez Codes d’erreur ADSI.
Notes
Cette méthode est utilisée pour gérer un chemin d’accès qui contient des caractères spéciaux dans une chaîne non échiffée en tant qu’entrée d’une interface utilisateur. La chaîne d’entrée doit être un seul élément (paire nom-valeur) du chemin d’accès ; autrement dit, « CN=Smith,Jeff ».
Exemples
L’exemple de code Visual Basic suivant montre l’effet produit par IADsPathname::GetEscapedElement. Une fois ce code exécuté, rdn contient « cn=smith,jeff ».
Dim x As New Pathname
rdn = x.GetEscapedElement(0, "cn=smith,jeff")
L’exemple de code VBScript suivant montre l’effet produit par IADsPathname::GetEscapedElement. Une fois ce code exécuté, rdn contient « cn=smith,jeff ».
Dim x
Set x = CreateObject("Pathname")
rdn = x.GetEscapedElement(0, "cn=smith,jeff")
L’exemple de code C++ suivant montre l’effet produit par IADsPathname::GetEscapedElement. Une fois ce code exécuté, rdn contient « 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();
Configuration requise
| Client minimal pris en charge | Windows Vista |
| Serveur minimal pris en charge | Windows Server 2008 |
| Plateforme cible | Windows |
| En-tête | iads.h |
| DLL | Activeds.dll |