IADsNameTranslate::Dapatkan metode (iads.h)

Artikel
03/05/2024

Metode IADsNameTranslate::Get mengambil nama objek direktori dalam format yang ditentukan. Nama yang dibedakan harus diatur dalam format yang sesuai dengan metode IADsNameTranslate::Set .

Sintaks

HRESULT Get(
  long lnFormatType,
  BSTR *pbstrADsPath
);

Parameter

lnFormatType

Jenis format nama output. Untuk informasi selengkapnya, lihat ADS_NAME_TYPE_ENUM. Metode ini tidak mendukung elemen ADS_NAME_TYPE_SID_OR_SID_HISTORY_NAME dalam ADS_NAME_TYPE_ENUM.

pbstrADsPath

Nama objek yang dikembalikan.

Nilai kembali

Metode ini mendukung nilai pengembalian HRESULT standar, termasuk:

Keterangan

Metode ini memungkinkan Anda mengambil nama objek direktori tunggal. Untuk mengambil nama beberapa objek, gunakan IADsNameTranslate::GetEx.

Ketika pengejaran rujukan aktif, metode ini akan mencoba mengejar dan menyelesaikan jalur objek tertentu yang tidak berada di server yang terhubung.

Contoh

Contoh kode C/C++ berikut menunjukkan cara menerjemahkan nama yang dibedakan yang sesuai dengan RFC 1779 ke format GUID. Nama komputer server direktori adalah "myServer".

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=jeff,CN=Users,DC=myDomain,DC=Fabrikam,DC=COM,O=Internet"));
if(FAILED(hr)) {exit 1;}
 
BSTR bstr;
hr = pNto->Get(ADS_NAME_TYPE_GUID, &bstr);
printf("Translation: %S\n", bstr);
 
SysFreeString(bstr);
pNto->Release();

Contoh kode Visual Basic berikut menunjukkan cara menerjemahkan nama yang dibedakan yang sesuai dengan RFC 1779 ke format GUID. Nama komputer server direktori adalah "myServer".

Dim nto As New NameTranslate
Dim result As String
 
dn = "CN=rob,CN=Users,DC=myDomain,DC=Fabrikam,DC=COM,O=Internet" 
nto.Init ADS_NAME_INITTYPE_SERVER, "myServer"
nto.Set ADS_NAME_TYPE_1779, dn
result = nto.Get ADS_NAME_TYPE_GUID
MsgBox result

Contoh kode VBScript/ASP berikut menunjukkan cara menerjemahkan nama yang dibedakan yang sesuai dengan RFC 1779 ke format GUID. Nama komputer server direktori adalah "myServer".

<%@ Language=VBScript %>
<html>
<body>
<%
  Dim nto
  const ADS_NAME_INITTYPE_SERVER = 2
  const ADS_NAME_TYPE_1779 = 1
  const ADS_NAME_TYPE_NT4 = 3
 
  server = "myServer"
  user   = "jeffsmith"
  dom    = "Fabrikam"
  passwd = "top secret" 
 
  Set nto = Server.CreateObject("NameTranslate")
  nto.InitEx ADS_NAME_INITTYPE_SERVER, server, user, dom, passwd
  nto.Set ADS_NAME_TYPE_1779, dn
  result = nto.Get(ADS_NAME_TYPE_GUID)
 
  Response.Write "<p>Translated name: " & result
 
%>
</body>
</html>

Persyaratan

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

Lihat juga

ADS_NAME_TYPE_ENUM

IADsNameTranslate

IADsNameTranslate::GetEx

IADsNameTranslate::Set

Bagikan melalui