Метод IADs::P ut (iads.h)

Статья
08/24/2023

Метод IADs::P ut задает значения атрибута в кэше атрибутов ADSI.

Синтаксис

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

Параметры

[in] bstrName

Содержит BSTR , задающий имя свойства.

[in] vProp

Содержит variant , указывающий новые значения свойства .

Возвращаемое значение

Этот метод поддерживает стандартные возвращаемые значения, а также следующие.

Дополнительные сведения и другие возвращаемые значения см. в разделе Коды ошибок ADSI.

Назначение новых значений свойств, выполняемое put , выполняется только в кэше свойств. Чтобы распространить изменения в хранилище каталогов, вызовите IADs::SetInfo для объекта после вызова Put.

Чтобы управлять значениями свойств, выходящими за рамки простого назначения, используйте команду Put , чтобы добавить или удалить значение из существующего массива значений атрибутов.

Примеры

В следующем примере кода показано, как использовать метод 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

В следующем примере кода показано, как использовать метод 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();

Требования


Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	iads.h
DLL	Activeds.dll