IADs::P ut-Methode (iads.h)
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 |