The IADsNameTranslate::InitEx method initializes a name translate object by binding to a specified directory server, domain, or global catalog, using the specified user credential. To initialize the object without an explicit user credential, use
IADsNameTranslate::Init.
The IADsNameTranslate::InitEx method initializes the object by setting the server or domain that the object will point to and supplying a user credential.
HRESULT InitEx(
long lnInitType,
BSTR bstrADsPath,
BSTR bstrUserID,
BSTR bstrDomain,
BSTR bstrPassword
);
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.
- bstrUserID
User name.
- bstrDomain
User domain name.
- bstrPassword
User password.
Return Value
Returns a standard HRESULT or RPC error code, including:
| Return code | Description |
| S_OK | Initialization succeeded. |
| E_FAIL | Initialization failed. |
| E_ADS_BAD_PARAMETER | lnInitType is invalid. |
| HRESULT_FROM_WIN32(ERROR_GEN_FAILURE) | An unspecified error occurred. |
Example Code
The following C/C++ code example uses the IADsNameTranslate::InitEx method to initialize an IADsNameTranslate 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->InitEx(ADS_NAME_INITTYPE_SERVER,
CComBSTR("myServer"),
CComBSTR("jeffsmith"),
CComBSTR("Fabrikam"),
CComBSTR("top secret"));
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();Example Code
[Visual Basic]
The following Visual Basic code example uses the IADsNameTranslate::InitEx method to initialize an IADsNameTranslate 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=jeffsmith, CN=users, DC=Fabrikam dc=COM"
server = "myServer"
domain = "Fabrikam"
user = "jeffsmith"
passwd = "myPass"
nto.InitEx ADS_NAME_INITTYPE_SERVER, server,user,domain,passwd
nto.Set ADS_NAME_TYPE_1779, dso
trans = nto.Get(ADS_NAME_TYPE_NT4)
MsgBox "Name in the translated format: " & trans
Example Code
[VBScript]
The following VBScript/ASP code example uses the IADsNameTranslate::InitEx method to initialize an IADsNameTranslate 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
server = "myServer"
domain = "Fabrikam"
user = "jeffsmith"
passwd = "myPass"
dn = "CN=jeffsmith,CN=Users,DC=Fabrikam,DC=COM"
Set nto = Server.CreateObject("NameTranslate")
nto.InitEx ADS_NAME_INITTYPE_SERVER, server,user,domain,passwd
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>Remarks
After the successful initialization, use the name translate object to submit requests of name translations of directory objects. For more information see
IADsNameTranslate::Set,
IADsNameTranslate::Get,
IADsNameTranslate::SetEx, or
IADsNameTranslate::GetEx.
Requirements
| Client | Requires Windows Vista, Windows XP, or Windows 2000 Professional. |
| Server | Requires Windows Server 2008, Windows Server 2003, or Windows 2000 Server. |
| Redistributable | Requires Active Directory Client Extension on Windows NT 4.0 and Windows Me/98/95. |
| Header | Declared in Iads.h. |
| DLL | Requires Activeds.dll. |
| IID | IID_IADsNameTranslate is defined as B1B272A3-3625-11D1-A3A4-00C04FB950DC. |
See Also
IADsNameTranslate
IADsNameTranslate::Get
IADsNameTranslate::GetEx
IADsNameTranslate::Set
IADsNameTranslate::SetEx
ADS_NAME_TYPE_ENUM
Send comments about this topic to Microsoft
Build date: 11/1/2007