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

Статья
02/26/2024

Метод IADs::SetInfo сохраняет кэшированные значения свойств объекта ADSI в базовом хранилище каталогов.

Синтаксис

HRESULT SetInfo();

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

Этот метод поддерживает стандартные возвращаемые значения, включая S_OK для успешной операции. Дополнительные сведения см. в разделе Коды ошибок ADSI.

Важно подчеркнуть различия между методами IADs::P ut и IADs::SetInfo . Первый задает (или изменяет) значения заданного свойства в кэше свойств, а второй распространяет изменения из кэша свойств в базовое хранилище каталогов. Таким образом, любые изменения значений свойств, внесенные IADs::P ut , будут потеряны, если IADs::GetInfo (или IADs::GetInfoEx) вызывается перед вызовом IADs::SetInfo .

Так как IADs::SetInfo отправляет данные между сетями, сведите к минимуму использование этого метода. Это сокращает количество обращений клиента к серверу. Например, следует зафиксировать все или большинство изменений свойств из кэша в постоянное хранилище в одном пакете.

Это руководство относится только к связи IADs::SetInfo с методом IADs::P ut , который отличается от связи с методом IADs::P utEx .

В следующем примере кода показана рекомендуемая связь между IADs::P ut и IADs::SetInfo.

Dim obj as IADs
 
obj.Put(prop1,val1)
obj.Put(prop2.val2)
obj.Put(prop3.val3)
obj.SetInfo

В следующем примере кода показано, что не рекомендуется использовать между IADs::P ut и IADs::SetInfo.

obj.Put(prop1,val1)
obj.SetInfo
obj.Put(prop2.val2)
obj.SetInfo
obj.Put(prop3.val3)
obj.SetInfo

При использовании с IADs::P utExIADs::SetInfo передает операционные запросы, заданные кодами управления, такими как ADS_PROPERTY_UPDATE или ADS_PROPERTY_CLEAR, в базовое хранилище каталогов.

Примеры

В следующем примере кода Visual Basic используется метод IADs::SetInfo для сохранения значения свойства пользователя в базовом каталоге.

Dim x as IADs
On Error GoTo Cleanup

Set x = GetObject("LDAP://CN=Administrator,CN=Users,DC=Fabrikam,DC=com")
'
' Update values in the cache.
'
x.Put "sn", "Smith"
x.Put "givenName", "Jeff"
x.Put "street", "1 Tanka Place"
x.Put "l", "Sammamish"
x.Put "st", "Washington"
'
' Commit changes to the directory.
x.SetInfo

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

Следующий пример кода C++ обновляет значения свойств в кэше свойств и фиксирует изменение в хранилище каталогов с помощью IADs::SetInfo. Для краткости проверка ошибок опущена.

IADs *pAds NULL;
VARIANT var;
HRESULT hr = S_OK;
LPWSTR path=L"LDAP://CN=Administrator,CN=Users,DC=Fabrikam,DC=com";
hr = ADsGetObject( path, IID_IADs, (void**) pADs);

if(!(hr==S_OK)) {return hr;}

VariantInit(&var);
// Update values in the cache.
V_BSTR(&var) = SysAllocString(L"Smith");
V_VT(&var) = VT_BSTR;
hr = pADs->Put(CComBSTR("sn"), var );
VariantClear(&var);
 
V_BSTR(&var) = SysAllocString(L"Jeff");
V_VT(&var) = VT_BSTR;
hr = pADs->Put(CComBSTR("givenName"), var );
VariantClear(&var);
 
V_BSTR(&var) = SysAllocString(L"1 Tanka Place");
V_VT(&var) = VT_BSTR;
hr = pADs->Put(CComBSTR("street"), var );
VariantClear(&var);
 
V_BSTR(&var) = SysAllocString(L"Sammamish");
V_VT(&var) = VT_BSTR;
hr = pADs->Put(CComBSTR("l"), var );
VariantClear(&var);
 
V_BSTR(&var) = SysAllocString(L"Washington");
V_VT(&var) = VT_BSTR;
hr = pADs->Put(CComBSTR("st"), var );
VariantClear(&var);
 
// Commit changes to the directory store.
hr = pADs->SetInfo();

if(pADs)
   pADs->Release();

Требования

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

См. также раздел