Método IADs::P ut (iads.h)

Artículo
08/24/2023

El método IADs::P ut establece los valores de un atributo en la caché de atributos ADSI.

Sintaxis

HRESULT Put(
  [in] BSTR    bstrName,
  [in] VARIANT vProp
);

Parámetros

[in] bstrName

Contiene un BSTR que especifica el nombre de la propiedad.

[in] vProp

Contiene un valor VARIANT que especifica los nuevos valores de la propiedad .

Valor devuelto

Este método admite los valores devueltos estándar, así como los siguientes.

Para obtener más información y otros valores devueltos, vea Códigos de error adsi.

Comentarios

La asignación de los nuevos valores de propiedad, realizados por Put solo tiene lugar en la memoria caché de propiedades. Para propagar los cambios en el almacén de directorios, llame a IADs::SetInfo en el objeto después de llamar a Put.

Para manipular los valores de propiedad más allá de una asignación simple, use Put para anexar o quitar un valor de una matriz existente de valores de atributo.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar el método IADs::P ut .

Dim x As IADs
On Error GoTo Cleanup

Set x = GetObject("LDAP://CN=JeffSmith,CN=Users,DC=Fabrikam, DC=Com") 
x.Put "givenName", "Jeff"
x.Put "sn", "Smith"
x.SetInfo    ' Commit to the directory.

Cleanup:
   If(Err.Number<>0) Then
      MsgBox("An error has occurred. " & Err.Number)
   End If
   Set x = Nothing

En el ejemplo de código siguiente se muestra cómo usar el método IADs::P ut .

HRESULT hr;
IADs *pADs = NULL;
LPWSTR pszADsPath = L"LDAP://CN=JeffSmith,CN=Users,DC=Fabrikam,DC=com";
 
CoInitialize(NULL);
 
//////////////////////////////////
// Modifying attributes using IADs
//////////////////////////////////
hr = ADsGetObject(pszADsPath, IID_IADs, (void**) &pADs);
 
if(SUCCEEDED(hr))
{ 
    VARIANT var;
    VariantInit(&var);
     
    // Set the first name.
    V_BSTR(&var) = SysAllocString(L"Jeff");
    V_VT(&var) = VT_BSTR;
    hr = pADs->Put(CComBSTR("givenName"), var);
     
    // Set the last name.
    VariantClear(&var);
    V_BSTR(&var) = SysAllocString(L"Smith");
    V_VT(&var) = VT_BSTR;
    hr = pADs->Put(CComBSTR("sn"), var); 
    VariantClear(&var);

    // Other Telephones.
    LPWSTR pszPhones[] = { L"425-707-9790", L"425-707-9791" };
    DWORD dwNumber = sizeof(pszPhones)/sizeof(LPWSTR);
    hr = ADsBuildVarArrayStr(pszPhones, dwNumber, &var);
    hr = pADs->Put(CComBSTR("otherTelephone"), var); 
    VariantClear(&var);
     
    // Commit the change to the directory.
    hr = pADs->SetInfo();
    pADs->Release();
}

CoUninitialize();

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