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所執行之新屬性值的指派只會在屬性快取中執行。若要將變更傳播至目錄存放區，請在呼叫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();