Método IADs::P ut (iads.h)

Artigo
08/24/2023

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