IADs::P ut, méthode (iads.h)
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 |