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

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, consulta Códigos de error ADSI.

Comentarios

La asignación de los nuevos valores de propiedad, realizados por Put solo se realiza 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

Consulte también

Iads

IADs::Get

IADs::GetEx

IADs::P utEx

Caché de propiedades