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

Artículo
02/29/2024

El método IADsNameTranslate::SetEx establece una matriz de objetos para la traducción de nombres. Los objetos especificados deben existir en el servidor de directorio conectado. Para establecer el nombre y el formato de un único objeto de directorio, use el método IADsNameTranslate::Set .

Sintaxis

HRESULT SetEx(
  long    lnFormatType,
  VARIANT pvar
);

Parámetros

lnFormatType

Tipo de formato de los nombres de entrada. Para obtener más información, consulte ADS_NAME_TYPE_ENUM.

pvar

Matriz variant de cadenas que contienen nombres de objeto.

Valor devuelto

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

Comentarios

No puede usar el método IADsNameTranslate::SetEx para establecer la traducción de nombres para objetos que residen en otros servidores, incluso cuando la opción de búsqueda de referencias está habilitada. Para obtener más información sobre el seguimiento de referencias, vea IADsNameTranslate (Métodos de propiedad).

Puede usar IADsNameTranslate::SetEx para establecer nombres para varios objetos. Sin embargo, todos los nombres deben tener el mismo formato.

Ejemplos

En el siguiente ejemplo de código de C/C++ se usa el método IADsNameTranslate::SetEx para configurar una matriz de objetos cuyos nombres se van a traducir del formato RFC 1779 al formato de nombre de usuario de Windows.

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;}
 
LPWSTR str[1] = { L"CN=jim,CN=Users,DC=myDomain,DC=Fabrikam,DC=COM",
                  L"CN=rob,CN=Users,DC=myDomain,DC=Fabrikam,DC=COM"};
DWORD dwNum = sizeof(str)/sizeof(LPWSTR);
 
VARIANT varStr;
VariantInit(&varStr);
 
hr = ADsBuildVarArrayStr(str,dwNum,&varStr);
 
hr =pNto->SetEx(ADS_NAME_TYPE_1779, varStr);
if(FAILED(hr)) {exit 1;}
VariantClear(&varStr);
 
hr = pNto->GetEx(ADS_NAME_TYPE_GUID, &varStr);
if(FAILED(hr)) {exit 1;}
 
LONG lstart, lend;
SAFEARRAY *sa = V_ARRAY(&varStr);
VARIANT varItem;
VariantInit(&varItem);
printf("Names in the translated format:\n");
for (long idx = lstart; idx <= lend; idx++) 
{
    hr = SafeArrayGetElement(sa, &idx, &varItem);
    printf("   %S\n", V_BSTR(&varItem));
    VariantClear(&varItem);
}
VariantClear(&varStr);
pNto->Release();

En el siguiente ejemplo de código de Visual Basic se usa el método IADsNameTranslate::SetEx para configurar una matriz de objetos cuyos nombres se van a traducir del formato RFC 1779 al formato de nombre de usuario del .

Dim nto As New NameTranslate
dso(0)="CN=jeffSmith, CN=users, DC=Fabrikam dc=COM"
dso(1)="CN=brendaDiaz, CN=users, DC=Fabrikam dc=COM"
nto.Init  ADS_NAME_INITTYPE_SERVER, "myServer"
nto.SetEx ADS_NAME_TYPE_1779, dso
trans = nto.GetEx(ADS_NAME_TYPE_NT4)   
Msgbox "Translations: " & trans(0) & "," & trans(1)

En el siguiente ejemplo de código VBScript/ASP se usa el método IADsNameTranslate::SetEx para configurar una matriz de objetos cuyos nombres se van a traducir del formato RFC 1779 al formato de nombre de usuario del .

<%@ 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(0) = "CN=jeffSmith,CN=Users,DC=Fabrikam,DC=COM" 
  dn(1) = "CN=brendaDiaz,CN=Users,DC=Fabrikam,DC=COM" 
 
  Set nto = Server.CreateObject("NameTranslate")
  nto.Init ADS_NAME_INITTYPE_SERVER, "myServer"
  nto.SetEx ADS_NAME_TYPE_1779, dn
  result = nto.GetEx(ADS_NAME_TYPE_NT4)
 
  Response.Write "<p>Name in the translated format: " & result(0) & _
       ", & result(1)
 
%>
</body>
</html>

Requisitos

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