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

  • Article

La méthode IADsNameTranslate ::Get récupère le nom d’un objet de répertoire au format spécifié. Le nom unique doit avoir été défini dans le format approprié par la méthode IADsNameTranslate ::Set .

Syntaxe

HRESULT Get(
  long lnFormatType,
  BSTR *pbstrADsPath
);

Paramètres

lnFormatType

Type de format du nom de sortie. Pour plus d’informations, consultez ADS_NAME_TYPE_ENUM. Cette méthode ne prend pas en charge l’élément ADS_NAME_TYPE_SID_OR_SID_HISTORY_NAME dans ADS_NAME_TYPE_ENUM.

pbstrADsPath

Nom de l’objet retourné.

Valeur retournée

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

Remarques

Cette méthode vous permet de récupérer le nom d’un objet de répertoire unique. Pour récupérer les noms de plusieurs objets, utilisez IADsNameTranslate ::GetEx.

Lorsque la recherche de référence est activée, cette méthode tente de rechercher et de résoudre le chemin d’accès d’un objet spécifié qui ne réside pas sur le serveur connecté.

Exemples

L’exemple de code C/C++ suivant montre comment traduire un nom unique conforme à RFC 1779 au format GUID. Le nom de l’ordinateur du serveur d’annuaire est « myServer ».

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=jeff,CN=Users,DC=myDomain,DC=Fabrikam,DC=COM,O=Internet"));
if(FAILED(hr)) {exit 1;}
 
BSTR bstr;
hr = pNto->Get(ADS_NAME_TYPE_GUID, &bstr);
printf("Translation: %S\n", bstr);
 
SysFreeString(bstr);
pNto->Release();

L’exemple de code Visual Basic suivant montre comment traduire un nom unique conforme RFC 1779 au format GUID. Le nom de l’ordinateur du serveur d’annuaire est « myServer ».

Dim nto As New NameTranslate
Dim result As String
 
dn = "CN=rob,CN=Users,DC=myDomain,DC=Fabrikam,DC=COM,O=Internet" 
nto.Init ADS_NAME_INITTYPE_SERVER, "myServer"
nto.Set ADS_NAME_TYPE_1779, dn
result = nto.Get ADS_NAME_TYPE_GUID
MsgBox result

L’exemple de code VBScript/ASP suivant montre comment traduire un nom unique conforme à RFC 1779 en un format GUID. Le nom de l’ordinateur du serveur d’annuaire est « myServer ».

<%@ Language=VBScript %>
<html>
<body>
<%
  Dim nto
  const ADS_NAME_INITTYPE_SERVER = 2
  const ADS_NAME_TYPE_1779 = 1
  const ADS_NAME_TYPE_NT4 = 3
 
  server = "myServer"
  user   = "jeffsmith"
  dom    = "Fabrikam"
  passwd = "top secret" 
 
  Set nto = Server.CreateObject("NameTranslate")
  nto.InitEx ADS_NAME_INITTYPE_SERVER, server, user, dom, passwd
  nto.Set ADS_NAME_TYPE_1779, dn
  result = nto.Get(ADS_NAME_TYPE_GUID)
 
  Response.Write "<p>Translated name: " & result
 
%>
</body>
</html>

Configuration requise

Condition requise Valeur
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

Voir aussi

ADS_NAME_TYPE_ENUM

IADsNameTranslate

IADsNameTranslate ::GetEx

IADsNameTranslate ::Set