IADsNameTranslate::Set, méthode (iads.h)

Article
08/24/2023

La méthode IADsNameTranslate::Set demande au service d’annuaire de configurer un objet spécifié pour la traduction de noms. Pour définir les noms et le format de plusieurs objets, utilisez IADsnametranslate::SetEx.

Syntaxe

HRESULT Set(
  long lnSetType,
  BSTR bstrADsPath
);

Paramètres

lnSetType

Format du nom d’un objet de répertoire. Pour plus d’informations, consultez ADS_NAME_TYPE_ENUM.

bstrADsPath

Nom de l’objet, par exemple, « CN=Administrator, CN=users, DC=Fabrikam, DC=com ».

Valeur retournée

Cette méthode prend en charge les valeurs de retour HRESULT standard, notamment :

Notes

Avant d’appeler cette méthode pour définir le nom de l’objet, vous devez avoir établi une connexion au service d’annuaire en utilisant IADsNameTranslate::Init ou IADsNameTranslate::InitEx.

Vous pouvez utiliser la méthode IADsNameTranslate::Set pour définir la traduction de noms pour les objets résidant sur le serveur d’annuaire. Lorsque la recherche de référence est activée, cette méthode définit également n’importe quel objet trouvé sur d’autres serveurs. Pour plus d’informations sur la recherche de références, consultez IADsNameTranslate Property Methods.

Exemples

L’exemple de code C/C++ suivant utilise la méthode IADsNameTranslate::Set pour définir un objet afin que son nom puisse être traduit du format RFC 1779 au format de nom d’utilisateur s.

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

L’exemple de code Visual Basic suivant utilise la méthode IADsNameTranslate::Set pour définir un objet afin que son nom puisse être traduit du format RFC 1779 au format de nom d’utilisateur s.

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)

L’exemple de code VBScript/ASP suivant utilise la méthode IADsNameTranslate::Set pour définir un objet afin que son nom soit traduit du format RFC 1779 au format de nom d’utilisateur s.

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

Configuration requise


Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Plateforme cible	Windows
En-tête	iads.h
DLL	Activeds.dll