Método IADsNameTranslate::Set (iads.h)

Artículo
08/24/2023

El método IADsNameTranslate::Set dirige el servicio de directorio para configurar un objeto especificado para la traducción de nombres. Para establecer los nombres y el formato de varios objetos, use IADsnametranslate::SetEx.

Sintaxis

HRESULT Set(
  long lnSetType,
  BSTR bstrADsPath
);

Parámetros

lnSetType

Formato del nombre de un objeto de directorio. Para obtener más información, consulte ADS_NAME_TYPE_ENUM.

bstrADsPath

El nombre del objeto, por ejemplo, "CN=Administrator, CN=users, DC=Fabrikam, DC=com".

Valor devuelto

Este método admite los valores devueltos HRESULT estándar, entre los que se incluyen:

Comentarios

Antes de llamar a este método para establecer el nombre del objeto, debe haber establecido una conexión al servicio de directorio mediante IADsNameTranslate::Init o IADsNameTranslate::InitEx.

Puede usar el método IADsNameTranslate::Set para establecer la traducción de nombres para los objetos que residen en el servidor de directorios. Cuando la búsqueda de referencias está activada, este método también establecerá cualquier objeto que se encuentre en otros servidores. Para obtener más información sobre el seguimiento de referencias, vea IADsNameTranslate (Métodos de propiedad).

Ejemplos

En el siguiente ejemplo de código de C/C++ se usa el método IADsNameTranslate::Set para establecer un objeto de modo que su nombre se pueda traducir del formato RFC 1779 al formato de nombre de usuario.

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

En el siguiente ejemplo de código de Visual Basic se usa el método IADsNameTranslate::Set para establecer un objeto de modo que su nombre se pueda traducir del formato RFC 1779 al formato de nombre de usuario.

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)

En el siguiente ejemplo de código VBScript/ASP se usa el método IADsNameTranslate::Set para establecer un objeto para que su nombre se traduzca del formato RFC 1779 al formato de nombre de usuario.

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

Requisitos


Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	iads.h
Archivo DLL	Activeds.dll