IADs::P ut-Methode (iads.h)

Artikel
08/24/2023

Die IADs::P ut-Methode legt die Werte eines Attributs im ADSI-Attributcache fest.

Syntax

HRESULT Put(
  [in] BSTR    bstrName,
  [in] VARIANT vProp
);

Parameter

[in] bstrName

Enthält einen BSTR , der den Eigenschaftennamen angibt.

[in] vProp

Enthält einen VARIANT-Wert , der die neuen Werte der -Eigenschaft angibt.

Rückgabewert

Diese Methode unterstützt die standardmäßigen Rückgabewerte sowie folgendes.

Weitere Informationen und andere Rückgabewerte finden Sie unter ADSI-Fehlercodes.

Hinweise

Die Zuweisung der neuen Eigenschaftswerte, die von Put ausgeführt wird, erfolgt nur im Eigenschaftencache. Um die Änderungen an den Verzeichnisspeicher weiterzuverbreiten, rufen Sie IADs::SetInfo für das Objekt auf, nachdem Put aufgerufen wurde.

Um die Eigenschaftswerte über eine einfache Zuweisung hinaus zu bearbeiten, verwenden Sie Put , um einen Wert aus einem vorhandenen Array von Attributwerten anzufügen oder daraus zu entfernen.

Beispiele

Im folgenden Codebeispiel wird die Verwendung der IADs::P ut-Methode veranschaulicht.

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

Im folgenden Codebeispiel wird die Verwendung der IADs::P ut-Methode veranschaulicht.

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

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	iads.h
DLL	Activeds.dll