IADsNameTranslate::Atur metode (iads.h)

Artikel
08/24/2023

Metode IADsNameTranslate::Set mengarahkan layanan direktori untuk menyiapkan objek tertentu untuk terjemahan nama. Untuk mengatur nama dan format beberapa objek, gunakan IADsnametranslate::SetEx.

Sintaks

HRESULT Set(
  long lnSetType,
  BSTR bstrADsPath
);

Parameter

lnSetType

Format nama objek direktori. Untuk informasi selengkapnya, lihat ADS_NAME_TYPE_ENUM.

bstrADsPath

Nama objek, misalnya, "CN=Administrator, CN=users, DC=Fabrikam, DC=com".

Mengembalikan nilai

Metode ini mendukung nilai pengembalian HRESULT standar, termasuk:

Keterangan

Sebelum memanggil metode ini untuk mengatur nama objek, Anda harus membuat koneksi ke layanan direktori menggunakan IADsNameTranslate::Init atau IADsNameTranslate::InitEx.

Anda dapat menggunakan metode IADsNameTranslate::Set untuk mengatur terjemahan nama untuk objek yang berada di server direktori. Ketika pengejaran rujukan aktif, metode ini juga akan mengatur objek apa pun yang ditemukan di server lain. Untuk informasi selengkapnya tentang pengejaran rujukan, lihat Metode Properti IADsNameTranslate.

Contoh

Contoh kode C/C++ berikut menggunakan metode IADsNameTranslate::Set untuk mengatur objek sehingga namanya dapat diterjemahkan dari format RFC 1779 ke format nama pengguna s.

IADsNameTranslate *pNto;
HRESULT hr;
hr = CoCreateInstance(CLSID_NameTranslate,
                      NULL,
                      CLSCTX_INPROC_SERVER,
                      IID_IADsNameTranslate,
                      (void**)&pNto);
if(FAILED(hr)) { exit 1;}
 
hr = pNto->Init(ADS_NAME_INITTYPE_SERVER,
                  CComBSTR("myServer"));
if (FAILED(hr)) { exit 1;}
 
hr =pNto->Set(ADS_NAME_TYPE_1779,
             CComBSTR("cn=jeffsmith,cn=users,dc=Fabrikam,dc=com"));
if(FAILED(hr)) {exit 1;}
 
BSTR bstr;
hr = pNto->Get(ADS_NAME_TYPE_NT4, &bstr);
printf("Name in the translated format: %S\n", bstr);
 
SysFreeString(bstr);
pNto->Release();

Contoh kode Visual Basic berikut menggunakan metode IADsNameTranslate::Set untuk mengatur objek sehingga namanya dapat diterjemahkan dari format RFC 1779 ke format nama pengguna s.

Dim nto As New NameTranslate
dso="CN=jeffsmith, CN=users, DC=Fabrikam dc=COM"
 
nto.Init ADS_NAME_INITTYPE_SERVER, "myServer"
nto.Set ADS_NAME_TYPE_1779, dso
trans = nto.Get(ADS_NAME_TYPE_NT4)

Contoh kode VBScript/ASP berikut menggunakan metode IADsNameTranslate::Set untuk mengatur objek agar namanya diterjemahkan dari format RFC 1779 ke format nama pengguna s.

<%@ Language=VBScript %>
<html>
<body>
<%
  Dim nto
  const ADS_NAME_INITTYPE_SERVER = 2  ' VBScript cannot read 
  const ADS_NAME_TYPE_1779 = 1        ' enumeration definition
  const ADS_NAME_TYPE_NT4 = 3
 
  dn = "CN=jeffsmith,CN=Users,DC=Fabrikam,DC=COM" 
 
  Set nto = Server.CreateObject("NameTranslate")
  nto.Init ADS_NAME_INITTYPE_SERVER, "myServer"
  nto.Set ADS_NAME_TYPE_1779, dn
  result = nto.Get(ADS_NAME_TYPE_NT4)
 
  Response.Write "<p>Name in the translated format: " & result
 
%>
</body>
</html>

Persyaratan


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