Método IADsNameTranslate::Set (iads.h)
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 |