IADs::P ut 方法 (iads.h)

IADs::P ut方法會設定 ADSI 屬性快取中的屬性值。

語法

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

參數

[in] bstrName

包含指定屬性名稱的 BSTR

[in] vProp

包含 VARIANT ,指定 屬性的新值。

傳回值

這個方法支援標準傳回值,以及下列各項。

如需詳細資訊和其他傳回值,請參閱 ADSI 錯誤碼

備註

Put執行的新屬性值指派只會在屬性快取中執行。 若要將變更傳播至目錄存放區,請在呼叫Put之後,在 物件上呼叫IADs::SetInfo

若要操作簡單指派以外的屬性值,請使用 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
標頭 iads.h
DLL Activeds.dll

另請參閱

IAD

IADs::Get

IADs::GetEx

IADs::P utEx

屬性快取