Método IADs::P ut (iads.h)
El método IADs::P ut establece los valores de un atributo en la caché de atributos ADSI.
Sintaxis
HRESULT Put(
[in] BSTR bstrName,
[in] VARIANT vProp
);
Parámetros
[in] bstrName
Contiene un BSTR que especifica el nombre de la propiedad.
[in] vProp
Contiene un valor VARIANT que especifica los nuevos valores de la propiedad .
Valor devuelto
Este método admite los valores devueltos estándar, así como los siguientes.
Para obtener más información y otros valores devueltos, vea Códigos de error adsi.
Comentarios
La asignación de los nuevos valores de propiedad, realizados por Put solo tiene lugar en la memoria caché de propiedades. Para propagar los cambios en el almacén de directorios, llame a IADs::SetInfo en el objeto después de llamar a Put.
Para manipular los valores de propiedad más allá de una asignación simple, use Put para anexar o quitar un valor de una matriz existente de valores de atributo.
Ejemplos
En el ejemplo de código siguiente se muestra cómo usar el método 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
En el ejemplo de código siguiente se muestra cómo usar el método 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();
Requisitos
| Cliente mínimo compatible | Windows Vista |
| Servidor mínimo compatible | Windows Server 2008 |
| Plataforma de destino | Windows |
| Encabezado | iads.h |
| Archivo DLL | Activeds.dll |