IADs::P ut 메서드(iads.h)

아티클
08/24/2023

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

요구 사항


지원되는 최소 클라이언트	Windows Vista
지원되는 최소 서버	Windows Server 2008
대상 플랫폼	Windows
헤더	iads.h
DLL	Activeds.dll