IADs::SetInfo 方法 (iads.h)

IADs::SetInfo方法會將 ADSI 物件的快取屬性值儲存至基礎目錄存放區。

語法

HRESULT SetInfo();

傳回值

這個方法支援標準傳回值,包括成功作業S_OK。 如需詳細資訊,請參閱 ADSI 錯誤碼

備註

請務必強調 IADs::P utIADs::SetInfo 方法之間的差異。 前者會設定 (或修改屬性快取中指定屬性的) 值,而後者則會將屬性快取的變更傳播到基礎目錄存放區。 因此,如果呼叫 IADs::SetInfo之前叫用IADs::GetInfo (或IADs::GetInfoEx) ,IADs:::P ut 所做的任何屬性值變更都會遺失。

由於 IADs::SetInfo 會跨網路傳送資料,因此請將此方法的使用降到最低。 這可減少用戶端對伺服器所做的行程數目。 例如,您應該認可所有或大部分的屬性變更,從快取到一個批次中的永續性存放區。

此指導方針僅與 IADs::SetInfoIADs::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 utEx使用時, IADs::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
標頭 iads.h
DLL Activeds.dll

另請參閱

IAD

IADs::GetInfo

IADs::GetInfoEx

IADs::P ut

IADs::P utEx