IADsNameTranslate::Set, méthode (iads.h)
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 |