IDirectoryObject::SetObjectAttributes 메서드(iads.h)

IDirectoryObject::SetObjectAttributes 메서드는 ADS_ATTR_INFO 구조에 정의된 하나 이상의 지정된 개체 특성에서 데이터를 수정합니다.

구문

HRESULT SetObjectAttributes(
  [in]  PADS_ATTR_INFO pAttributeEntries,
  [in]  DWORD          dwNumAttributes,
  [out] DWORD          *pdwNumAttributesModified
);

매개 변수

[in] pAttributeEntries

수정할 특성의 배열을 제공합니다. 각 특성에는 특성 이름, 수행할 작업 및 해당하는 경우 특성 값이 포함됩니다. 자세한 내용은 ADS_ATTR_INFO 구조를 참조하세요.

[in] dwNumAttributes

수정할 특성 수를 제공합니다. 이 값은 pAttributeEntries 배열의 크기에 해당해야 합니다.

[out] pdwNumAttributesModified

SetObjectAttributes 메서드에서 수정한 특성 수를 포함하는 DWORD 변수에 대한 포인터를 제공합니다.

반환 값

이 메서드는 특성이 성공적으로 설정된 경우 S_OK 포함하여 표준 반환 값을 반환합니다.

자세한 내용 및 기타 반환 값은 ADSI 오류 코드를 참조하세요.

설명

LDAP 공급자(Active Directory)에서 IDirectoryObject::SetObjectAttributes 메서드는 트랜잭션된 호출입니다. 특성은 모두 커밋되거나 삭제됩니다. 다른 디렉터리 공급자는 호출을 거래하지 않을 수 있습니다.

Active Directory는 다중값 특성에 중복 값을 허용하지 않습니다. 그러나 SetObjectAttributes 를 호출하여 Active Directory 개체의 다중 값 특성에 중복 값을 추가하는 경우 SetObjectAttributes 호출은 성공하지만 중복 값은 무시됩니다.

마찬가지로 SetObjectAttributes 를 사용하여 Active Directory 개체의 다중 값 속성에서 하나 이상의 값을 삭제하는 경우 속성에 대해 지정된 값 중 하나 또는 전부가 설정되지 않은 경우에도 작업이 성공합니다.

예제

다음 C++ 코드 예제에서는 사용자 개체 의 sn 특성을 대/소문자를 구분하지 않는 문자열로 Price 값으로 설정합니다.

HRESULT hr;
IDirectoryObject *pDirObject=NULL;
DWORD  dwReturn;
ADSVALUE  snValue;
ADS_ATTR_INFO attrInfo[] = { {L"sn",ADS_ATTR_UPDATE, ADSTYPE_CASE_IGNORE_STRING, &snValue, 1} };
DWORD dwAttrs = sizeof(attrInfo)/sizeof(ADS_ATTR_INFO); 
 
snValue.dwType=ADSTYPE_CASE_IGNORE_STRING;
snValue.CaseIgnoreString = L"Price";
 
hr = ADsGetObject(L"LDAP://CN=Jeff Smith,OU=Sales,DC=Fabrikam,DC=com",
        IID_IDirectoryObject, 
        (void**) &pDirObject );
 
if ( SUCCEEDED(hr) )
{
    hr = pDirObject->SetObjectAttributes(attrInfo, dwAttrs, &dwReturn);

    pDirObject->Release();
}

요구 사항

참고 항목

ADSI 오류 코드

ADS_ATTR_INFO

IDirectoryObject