IADs::P ut method (iads.h)

Artikel
08/24/2023

Metode IADs::P ut menetapkan nilai atribut dalam cache atribut ADSI.

Sintaks

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

Parameter

[in] bstrName

Berisi BSTR yang menentukan nama properti.

[in] vProp

Berisi VARIAN yang menentukan nilai baru properti.

Mengembalikan nilai

Metode ini mendukung nilai pengembalian standar, serta yang berikut ini.

Untuk informasi selengkapnya, dan nilai pengembalian lainnya, lihat Kode Kesalahan ADSI.

Keterangan

Penetapan nilai properti baru, yang dilakukan oleh Put hanya terjadi di cache properti. Untuk menyebarkan perubahan ke penyimpanan direktori, panggil IAD::SetInfo pada objek setelah memanggil Put.

Untuk memanipulasi nilai properti di luar penugasan sederhana, gunakan Put untuk menambahkan atau menghapus nilai dari array nilai atribut yang ada.

Contoh

Contoh kode berikut menunjukkan cara menggunakan metode 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

Contoh kode berikut menunjukkan cara menggunakan metode 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();

Persyaratan


Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Target Platform	Windows
Header	iads.h
DLL	Activeds.dll