IADs ::SetInfo, méthode (iads.h)

Article
02/26/2024

La méthode IADs ::SetInfo enregistre les valeurs de propriété mises en cache de l’objet ADSI dans le magasin de répertoires sous-jacent.

Syntaxe

HRESULT SetInfo();

Valeur de retour

Cette méthode prend en charge les valeurs de retour standard, y compris les S_OK pour une opération réussie. Pour plus d’informations, consultez Codes d’erreur ADSI.

Remarques

Il est important de souligner les différences entre les méthodes IADs ::P ut et IADs ::SetInfo . Le premier définit (ou modifie) les valeurs d’une propriété donnée dans le cache de propriétés, tandis que le second propage les modifications du cache de propriétés dans le magasin de répertoires sous-jacent. Par conséquent, les modifications de valeur de propriété apportées par IADs ::P ut seront perdues si IADs ::GetInfo (ou IADs ::GetInfoEx) sont appelées avant l’appel d’IADs ::SetInfo .

Étant donné que IADs ::SetInfo envoie des données entre réseaux, réduisez l’utilisation de cette méthode. Cela réduit le nombre de déplacements qu’un client effectue vers le serveur. Par exemple, vous devez valider la totalité ou la plupart des modifications apportées aux propriétés du cache vers le magasin persistant dans un seul lot.

Cette directive concerne uniquement la relation entre IADs ::SetInfo et la méthode IADs ::P ut , qui diffère de la relation avec la méthode IADs ::P utEx .

L’exemple de code suivant illustre la relation recommandée entre IADs ::P ut et IADs ::SetInfo.

Dim obj as IADs
 
obj.Put(prop1,val1)
obj.Put(prop2.val2)
obj.Put(prop3.val3)
obj.SetInfo

L’exemple de code suivant illustre ce qui n’est pas recommandé entre IADs ::P ut et IADs ::SetInfo.

obj.Put(prop1,val1)
obj.SetInfo
obj.Put(prop2.val2)
obj.SetInfo
obj.Put(prop3.val3)
obj.SetInfo

Lorsqu’il est utilisé avec IADs ::P utEx, IADs ::SetInfo transmet les requêtes opérationnelles spécifiées par les codes de contrôle, tels que ADS_PROPERTY_UPDATE ou ADS_PROPERTY_CLEAR, au magasin d’annuaires sous-jacent.

Exemples

L’exemple de code Visual Basic suivant utilise la méthode IADs ::SetInfo pour enregistrer la valeur de propriété d’un utilisateur dans le répertoire sous-jacent.

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

L’exemple de code C++ suivant met à jour les valeurs de propriété dans le cache de propriétés et valide la modification du magasin d’annuaires à l’aide de IADs ::SetInfo. Par souci de concision, la vérification des erreurs est omise.

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();

Configuration requise

Condition requise	Valeur
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

Voir aussi