Método IADs::P ut (iads.h)
O método IADs::P ut define os valores de um atributo no cache de atributo ADSI.
Sintaxe
HRESULT Put(
[in] BSTR bstrName,
[in] VARIANT vProp
);
Parâmetros
[in] bstrName
Contém um BSTR que especifica o nome da propriedade.
[in] vProp
Contém uma VARIANT que especifica os novos valores da propriedade .
Valor retornado
Esse método dá suporte aos valores retornados padrão, bem como aos seguintes.
Para obter mais informações e outros valores retornados, consulte Códigos de erro ADSI.
Comentários
A atribuição dos novos valores de propriedade, executada por Put , ocorre apenas no cache de propriedades. Para propagar as alterações no repositório de diretórios, chame IADs::SetInfo no objeto depois de chamar Put.
Para manipular os valores de propriedade além de uma atribuição simples, use Put para acrescentar ou remover um valor de uma matriz existente de valores de atributo.
Exemplos
O exemplo de código a seguir mostra como usar o 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
O exemplo de código a seguir mostra como usar o 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 com suporte | Windows Vista |
| Servidor mínimo com suporte | Windows Server 2008 |
| Plataforma de Destino | Windows |
| Cabeçalho | iads.h |
| DLL | Activeds.dll |