IADsNameTranslate::Set-Methode (iads.h)

Artikel
08/24/2023

Die IADsNameTranslate::Set-Methode weist den Verzeichnisdienst an, ein angegebenes Objekt für die Namensübersetzung einzurichten. Um die Namen und das Format mehrerer Objekte festzulegen, verwenden Sie IADsnametranslate::SetEx.

Syntax

HRESULT Set(
  long lnSetType,
  BSTR bstrADsPath
);

Parameter

lnSetType

Das Format des Namens eines Verzeichnisobjekts. Weitere Informationen finden Sie unter ADS_NAME_TYPE_ENUM.

bstrADsPath

Der Objektname, z. B. "CN=Administrator, CN=users, DC=Fabrikam, DC=com".

Rückgabewert

Diese Methode unterstützt die HRESULT-Standardrückgabewerte, einschließlich:

Hinweise

Bevor Sie diese Methode zum Festlegen des Objektnamens aufrufen, sollten Sie eine Verbindung mit dem Verzeichnisdienst hergestellt haben, indem Sie entweder IADsNameTranslate::Init oder IADsNameTranslate::InitEx verwenden.

Sie können die IADsNameTranslate::Set-Methode verwenden, um die Namensübersetzung für Objekte festzulegen, die sich auf dem Verzeichnisserver befinden. Wenn die Verweisjagd aktiviert ist, legt diese Methode auch jedes Objekt fest, das auf anderen Servern gefunden wird. Weitere Informationen zur Empfehlungssuche finden Sie unter Methoden der IADsNameTranslate-Eigenschaft.

Beispiele

Im folgenden C/C++-Codebeispiel wird die IADsNameTranslate::Set-Methode verwendet, um ein Objekt festzulegen, damit sein Name aus dem RFC 1779-Format in das s-Benutzernamenformat übersetzt werden kann.

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::Set-Methode verwendet, um ein Objekt festzulegen, damit sein Name aus dem RFC 1779-Format in das Benutzernamenformat s übersetzt werden kann.

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::Set-Methode verwendet, um ein Objekt so festzulegen, dass sein Name aus dem RFC 1779-Format in das Benutzernamenformat s übersetzt 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