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