Platform SDK: Active Directory, ADSI, and Directory Services

IADsNameTranslate::Init

The IADsNameTranslate::Init method initializes a name translate object by binding to a specified directory server, domain, or global catalog, using the credentials of the currently logged on user. To initialize the object with a different user credential, use IADsNameTranslate::InitEx.

HRESULT IADsNameTranslate::Init(
  long lnInitType,
  BSTR bstrADsPath
);

Parameters

lnInitType: A type of initialization to be performed. Possible values are defined in ADS_NAME_INITTYPE_ENUM.
bstrADsPath: The name of the server or domain, depending on the value of lnInitType. When ADS_NAME_INITTYPE_GC is issued, this parameter is ignored. The global catalog server of the domain of the current machine will be used to carry out the name translate operations. This method will fail if the computer is not part of a domain as no global catalog will be found in this scenario. For more information, see ADS_NAME_INITTYPE_ENUM.

Return Values

This method supports the standard HRESULT return values, including:

S_OK: Initialization is successful.
E_FAIL: Initialization has failed.

Remarks

After the successful initialization, you can proceed to use the name translate object to submit requests of name translations of objects in the directory. For more information, see IADsNameTranslate::Set, or IADsNameTranslate::Get.

Example Code [C++]

The following C/C++ code snippet uses the IADsNameTranslate::Init method to initialize a NameTranslate object before the distinguished name of a user object is rendered in the Windows NT® 4.0 format.

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,
                  L"myServer");
if (FAILED(hr)) { exit 1;}
 
hr =pNto->Set(ADS_NAME_TYPE_1779,
             L"cn=jsmith,cn=users,dc=Microsoft,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();

Example Code [Visual Basic]

The following Visual Basic® code snippet uses the IADsNameTranslate::Init method to initialize the NameTranslate object in order to have the distinguished name of a user object rendered in the Windows NT 4.0 user name format.

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

Example Code [VBScript]

The following VBScript/ASP code snippet uses the IADsNameTranslate::Init method to initialize the NameTranslate object in order to have the distinguished name of a user object rendered in the Windows NT 4.0 user name format.

<%@ 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=jsmith,CN=Users,DC=Microsoft,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>

Requirements

  Windows NT/2000: Requires Windows 2000 (or Windows NT 4.0 with DSClient).
  Windows 95/98: Requires Windows 95 or later (with DSClient).
  Header: Declared in Iads.h.