IADsNameTranslate::InitEx-Methode (iads.h)

Artikel
02/29/2024

Die IADsNameTranslate::InitEx-Methode initialisiert ein Name translate-Objekt durch Bindung an einen angegebenen Verzeichnisserver, eine angegebene Domäne oder einen angegebenen globalen Katalog unter Verwendung der angegebenen Benutzeranmeldeinformationen. Um das Objekt ohne explizite Benutzeranmeldeinformationen zu initialisieren, verwenden Sie IADsNameTranslate::Init.

Die IADsNameTranslate::InitEx-Methode initialisiert das -Objekt, indem der Server oder die Domäne festgelegt wird, auf die das Objekt verweist, und gibt benutzeranmeldeinformationen an.

Syntax

HRESULT InitEx(
  long lnSetType,
  BSTR bstrADsPath,
  BSTR bstrUserID,
  BSTR bstrDomain,
  BSTR bstrPassword
);

Parameter

lnSetType

Eine Art der auszuführenden Initialisierung. Mögliche Werte werden in ADS_NAME_INITTYPE_ENUM definiert.

bstrADsPath

Der Name des Servers oder der Domäne, abhängig vom Wert von lnInitType. Wenn ADS_NAME_INITTYPE_GC ausgegeben wird, wird dieser Parameter ignoriert. Der globale Katalogserver der Domäne des aktuellen Computers wird zum Ausführen der Namensübersetzungsvorgänge verwendet. Diese Methode schlägt fehl, wenn der Computer nicht Teil einer Domäne ist, da in diesem Szenario kein globaler Katalog gefunden wird. Weitere Informationen finden Sie unter ADS_NAME_INITTYPE_ENUM.

bstrUserID

Benutzername.

bstrDomain

Benutzerdomänenname.

bstrPassword

Benutzerkennwort.

Rückgabewert

Gibt einen Standardmäßigen HRESULT - oder RPC-Fehlercode zurück, einschließlich:

Hinweise

Verwenden Sie nach der erfolgreichen Initialisierung das Name translate-Objekt, um Anforderungen an Namensübersetzungen von Verzeichnisobjekten zu übermitteln. Weitere Informationen finden Sie unter IADsNameTranslate::Set, IADsNameTranslate::Get, IADsNameTranslate::SetEx oder IADsNameTranslate::GetEx.

Beispiele

Im folgenden C/C++-Codebeispiel wird die IADsNameTranslate::InitEx-Methode verwendet, um ein IADsNameTranslate-Objekt zu initialisieren, bevor der distinguished Name eines Benutzerobjekts im s-Format gerendert wird.

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();

Im folgenden Visual Basic-Codebeispiel wird die IADsNameTranslate::InitEx-Methode verwendet, um ein IADsNameTranslate-Objekt zu initialisieren, um den distinguished Name eines Benutzerobjekts im Benutzernamenformat s rendern zu lassen.

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

Im folgenden VBScript/ASP-Codebeispiel wird die IADsNameTranslate::InitEx-Methode verwendet, um ein IADsNameTranslate-Objekt zu initialisieren, damit der distinguished Name eines Benutzerobjekts im Benutzernamenformat s gerendert wird.

<%@ 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>

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	iads.h
DLL	Activeds.dll