IADs::P ut メソッド (iads.h)

IADs::P ut メソッドは、ADSI 属性キャッシュ内の属性の値を設定します。

構文

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

パラメーター

[in] bstrName

プロパティ名を指定する BSTR が含まれます。

[in] vProp

プロパティの新しい値を指定する VARIANT を格納します。

戻り値

このメソッドは、標準の戻り値と、次の値をサポートします。

詳細およびその他の戻り値については、「 ADSI エラー コード」を参照してください。

解説

Put によって実行される新しいプロパティ値の割り当ては、プロパティ キャッシュでのみ行われます。 変更をディレクトリ ストアに反映するには、Put を呼び出した後、オブジェクトで IADs::SetInfo を呼び出します。

単純な代入以外のプロパティ値を操作するには、 Put を 使用して、属性値の既存の配列に値を追加または削除します。

例

次のコード例は、 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

次のコード例は、 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();

要件

関連項目

Iad

IADs::Get

IADs::GetEx

IADs::P utEx

プロパティ キャッシュ