IADsPathname::GetEscapedElement-Methode (iads.h)

Die IADsPathname::GetEscapedElement-Methode wird verwendet, um Sonderzeichen im Eingabepfad zu escapen.

Syntax

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

Parameter

[in] lnReserved

Für die zukünftige Verwendung reserviert.

[in] bstrInStr

Eine Eingabezeichenfolge.

[out] pbstrOutStr

Eine Ausgabezeichenfolge.

Rückgabewert

Diese Methode unterstützt die Standardmäßigen Rückgabewerte sowie Folgendes:

Weitere Informationen und andere Rückgabewerte finden Sie unter ADSI-Fehlercodes.

Hinweise

Diese Methode wird verwendet, um einen Pfad zu behandeln, der Sonderzeichen in einer Zeichenfolge ohne Zeichen als Eingabe von einer Benutzeroberfläche enthält. Die Eingabezeichenfolge muss ein einzelnes Element (Name-Wert-Paar) des Pfads sein. d. h. "CN=Smith,Jeff".

Beispiele

Das folgende Visual Basic-Codebeispiel zeigt den Effekt, der von IADsPathname::GetEscapedElement erzeugt wird. Nachdem dieser Code ausgeführt wurde, enthält rdn "cn=smith,jeff".

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

Das folgende VBScript-Codebeispiel zeigt den Effekt, der von IADsPathname::GetEscapedElement erzeugt wird. Nachdem dieser Code ausgeführt wurde, enthält rdn "cn=smith,jeff".

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

Das folgende C++-Codebeispiel zeigt den Effekt, der von IADsPathname::GetEscapedElement erzeugt wird. Nachdem dieser Code ausgeführt wurde, enthält rdn "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();

Anforderungen

Weitere Informationen

ADSI-Fehlercodes

IADsPathname