Metode IADsPathname::GetEscapedElement (iads.h)

Metode IADsPathname::GetEscapedElement digunakan untuk menghindari karakter khusus di jalur input.

Sintaks

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

Parameter

[in] lnReserved

Disiapkan untuk penggunaan masa mendatang.

[in] bstrInStr

String input.

[out] pbstrOutStr

String output.

Nilai kembali

Metode ini mendukung nilai pengembalian standar, serta yang berikut ini:

Untuk informasi selengkapnya dan nilai pengembalian lainnya, lihat Kode Kesalahan ADSI.

Keterangan

Metode ini digunakan untuk menangani jalur yang berisi karakter khusus dalam unescaped string sebagai input dari antarmuka pengguna. String input harus berupa elemen tunggal (pasangan nama-nilai) dari jalur; yaitu, "CN=Smith,Jeff".

Contoh

Contoh kode Visual Basic berikut menunjukkan efek yang dihasilkan oleh IADsPathname::GetEscapedElement. Setelah kode ini dijalankan, rdn akan berisi "cn=smith,jeff".

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

Contoh kode VBScript berikut menunjukkan efek yang dihasilkan oleh IADsPathname::GetEscapedElement. Setelah kode ini dijalankan, rdn akan berisi "cn=smith,jeff".

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

Contoh kode C++ berikut menunjukkan efek yang dihasilkan oleh IADsPathname::GetEscapedElement. Setelah kode ini dijalankan, rdn akan berisi "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();

Persyaratan

Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Target Platform	Windows
Header	iads.h
DLL	Activeds.dll

Lihat juga

Kode Kesalahan ADSI

IADsPathname