Metodo IADsPathname::GetEscapedElement (iads.h)
Il metodo IADsPathname::GetEscapedElement viene utilizzato per eseguire l'escape di caratteri speciali nel percorso di input.
Sintassi
HRESULT GetEscapedElement(
[in] long lnReserved,
[in] BSTR bstrInStr,
[out] BSTR *pbstrOutStr
);
Parametri
[in] lnReserved
Riservato per utilizzi futuri.
[in] bstrInStr
Stringa di input.
[out] pbstrOutStr
Stringa di output.
Valore restituito
Questo metodo supporta i valori restituiti standard, nonché i seguenti:
Per altre informazioni e altri valori restituiti, vedere Codici di errore ADSI.
Commenti
Questo metodo viene usato per gestire un percorso che contiene caratteri speciali in una stringa senza caratteri di escape come input da un'interfaccia utente. La stringa di input deve essere un singolo elemento (coppia nome-valore) del percorso; vale a dire, "CN=Smith,Jeff".
Esempio
Nell'esempio di codice di Visual Basic seguente viene illustrato l'effetto prodotto da IADsPathname::GetEscapedElement. Dopo l'esecuzione di questo codice, rdn conterrà "cn=smith,jeff".
Dim x As New Pathname
rdn = x.GetEscapedElement(0, "cn=smith,jeff")
Nell'esempio di codice VBScript seguente viene illustrato l'effetto prodotto da IADsPathname::GetEscapedElement. Dopo l'esecuzione di questo codice, rdn conterrà "cn=smith,jeff".
Dim x
Set x = CreateObject("Pathname")
rdn = x.GetEscapedElement(0, "cn=smith,jeff")
L'esempio di codice C++ seguente mostra l'effetto prodotto da IADsPathname::GetEscapedElement. Dopo l'esecuzione di questo codice, rdn conterrà "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();
Requisiti
| Client minimo supportato | Windows Vista |
| Server minimo supportato | Windows Server 2008 |
| Piattaforma di destinazione | Windows |
| Intestazione | iads.h |
| DLL | Activeds.dll |