IADs::P ut, méthode (iads.h)

Article
08/24/2023

La méthode IADs::P ut définit les valeurs d’un attribut dans le cache d’attributs ADSI.

Syntaxe

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

Paramètres

[in] bstrName

Contient un BSTR qui spécifie le nom de la propriété.

[in] vProp

Contient un VARIANT qui spécifie les nouvelles valeurs de la propriété .

Valeur retournée

Cette méthode prend en charge les valeurs de retour standard, ainsi que les éléments suivants.

Pour plus d’informations et d’autres valeurs de retour, consultez Codes d’erreur ADSI.

Notes

L’affectation des nouvelles valeurs de propriété, effectuée par Put , a lieu uniquement dans le cache de propriétés. Pour propager les modifications au magasin d’annuaires, appelez IADs::SetInfo sur l’objet après avoir appelé Put.

Pour manipuler les valeurs de propriété au-delà d’une simple affectation, utilisez Put pour ajouter ou supprimer une valeur d’un tableau existant de valeurs d’attributs.

Exemples

L’exemple de code suivant montre comment utiliser la méthode 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

L’exemple de code suivant montre comment utiliser la méthode 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();

Configuration requise


Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Plateforme cible	Windows
En-tête	iads.h
DLL	Activeds.dll