IADsNameTranslate::Init-Methode (iads.h)

Artikel
08/24/2023

Die IADsNameTranslate::Init-Methode initialisiert ein Namensübersetzungsobjekt, indem sie mit den Anmeldeinformationen des aktuellen Benutzers an einen angegebenen Verzeichnisserver, eine angegebene Domäne oder einen globalen Katalog gebunden wird. Um das Objekt mit anderen Benutzeranmeldeinformationen zu initialisieren, verwenden Sie IADsNameTranslate::InitEx.

Syntax

HRESULT Init(
  long lnSetType,
  BSTR bstrADsPath
);

Parameter

lnSetType

Ein Typ 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 führt die Namensübersetzungsvorgänge aus. 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.

Rückgabewert

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

Hinweise

Nach der erfolgreichen Initialisierung können Sie mit dem Namensübersetzungsobjekt fortfahren, um Anforderungen für Namensübersetzungen von Objekten im Verzeichnis zu übermitteln. Weitere Informationen finden Sie unter IADsNameTranslate::Set oder IADsNameTranslate::Get.

Beispiele

Im folgenden C/C++-Codebeispiel wird die IADsNameTranslate::Init-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->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();

Im folgenden Visual Basic-Codebeispiel wird die IADsNameTranslate::Init-Methode verwendet, um ein IADsNameTranslate-Objekt zu initialisieren, damit der distinguished Name eines Benutzerobjekts im Benutzernamenformat s gerendert wird.

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)

Im folgenden VBScript/ASP-Codebeispiel wird die IADsNameTranslate::Init-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
 
  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>

Anforderungen


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