다음을 통해 공유

IADsUser 속성 메서드

  • 아티클

IADsUser 인터페이스의 속성 메서드는 다음 표에 설명된 속성을 얻거나 설정합니다. 자세한 내용은 인터페이스 속성 메서드를 참조하세요.

속성

AccountDisabled

계정이 비활성화되었는지 여부를 나타내는 플래그입니다.

액세스 형식: 읽기/쓰기

스크립팅 데이터 형식: 부울

// C++ method syntax
HRESULT get_AccountDisabled(
  [out] VARIANT_BOOL* pfAccountDisabled
);
HRESULT put_AccountDisabled(
  [in] VARIANT_BOOL fAccountDisabled
);

AccountExpirationDate

사용자가 로그온할 수 없는 날짜 및 시간입니다.

액세스 형식: 읽기/쓰기

스크립팅 데이터 형식: DATE

// C++ method syntax
HRESULT get_AccountExpirationDate(
  [out] DATE* pdateAccountExpirationDate
);
HRESULT put_AccountExpirationDate(
  [in] DATE dateAccountExpirationDate
);

BadLoginAddress

가능한 침입자로 간주되는 마지막 노드입니다. 이 기능은 침입자 검색이 활성 상태인 경우 사용할 수 있습니다.

액세스 형식: 읽기 전용

데이터 형식 스크립팅: BSTR

// C++ method syntax
HRESULT get_BadLoginAddress(
  [out] BSTR* pbstrBadLoginAddress
);

BadLoginCount

마지막 재설정 이후 잘못된 로그온 시도 횟수입니다.

액세스 형식: 읽기 전용

스크립팅 데이터 형식: LONG

// C++ method syntax
HRESULT get_BadLoginCount(
  [out] LONG* plBadLoginCount
);

부서

사용자가 속한 회사 내의 OU(조직 구성 단위)인 부서입니다.

액세스 형식: 읽기/쓰기

데이터 형식 스크립팅: BSTR

// C++ method syntax
HRESULT get_Department(
  [out] BSTR* pbstrDepartment
);
HRESULT put_Department(
  [in] BSTR bstrDepartment
);

설명

사용자의 텍스트 설명입니다.

액세스 형식: 읽기/쓰기

데이터 형식 스크립팅: BSTR

// C++ method syntax
HRESULT get_Description(
  [out] BSTR* pbstrDescription
);
HRESULT put_Description(
  [in] BSTR bstrDescription
);

사업부

회사 또는 organization 내의 부서입니다.

액세스 형식: 읽기/쓰기

데이터 형식 스크립팅: BSTR

// C++ method syntax
HRESULT get_Division(
  [out] BSTR* pbstrDivision
);
HRESULT put_Division(
  [in] BSTR bstrDivision
);

EmailAddress

사용자의 이메일 주소입니다.

액세스 형식: 읽기/쓰기

데이터 형식 스크립팅: BSTR

// C++ method syntax
HRESULT get_EmailAddress(
  [out] BSTR* pbstrEmailAddress
);
HRESULT put_EmailAddress(
  [in] BSTR bstrEmailAddress
);

EmployeeID

사용자의 직원 식별자입니다.

액세스 형식: 읽기/쓰기

데이터 형식 스크립팅: BSTR

// C++ method syntax
HRESULT get_EmployeeID(
  [out] BSTR* pbstrEmployeeID
);
HRESULT put_EmployeeID(
  [in] BSTR bstrEmployeeID
);

팩스 번호

사용자의 팩스 번호 또는 숫자입니다. Active Directory에서 이 속성은 단일 값이며 VARIANT 배열에는 하나의 요소가 있습니다.

액세스 형식: 읽기/쓰기

데이터 형식 스크립팅: VARIANT

// C++ method syntax
HRESULT get_FaxNumber(
  [out] VARIANT* pvarFaxNumber
);
HRESULT put_FaxNumber(
  [in] VARIANT varFaxNumber
);

FirstName

사용자의 이름입니다.

액세스 형식: 읽기/쓰기

데이터 형식 스크립팅: BSTR

// C++ method syntax
HRESULT get_FirstName(
  [out] BSTR* pbstrFirstName
);
HRESULT put_FirstName(
  [in] BSTR bstrFirstName
);

FullName

사용자의 전체 이름입니다.

액세스 형식: 읽기/쓰기

데이터 형식 스크립팅: BSTR

// C++ method syntax
HRESULT get_FullName(
  [out] BSTR* pbstrFullName
);
HRESULT put_FullName(
  [in] BSTR bstrFullName
);

GraceLoginsAllowed

암호가 만료된 후 사용자가 로그온할 수 있는 횟수입니다.

액세스 형식: 읽기/쓰기

스크립팅 데이터 형식: LONG

// C++ method syntax
HRESULT get_GraceLoginsAllowed(
  [out] LONG* plGraceLoginsAllowed
);
HRESULT put_GraceLoginsAllowed(
  [in] LONG lGraceLoginsAllowed
);

GraceLoginsRemaining

계정이 잠기기 전에 허용되는 로그온 수입니다.

액세스 형식: 읽기/쓰기

스크립팅 데이터 형식: LONG

// C++ method syntax
HRESULT get_GraceLoginsRemaining(
  [out] LONG* plGraceLoginsRemaining
);
HRESULT put_GraceLoginsRemaining(
  [in] LONG lGraceLoginsRemaining
);

HomeDirectory

사용자의 홈 디렉터리입니다.

액세스 형식: 읽기/쓰기

데이터 형식 스크립팅: BSTR

// C++ method syntax
HRESULT get_HomeDirectory(
  [out] BSTR* pbstrHomeDirectory
);
HRESULT put_HomeDirectory(
  [in] BSTR bstrHomeDirectory
);

홈페이지

사용자의 홈페이지에 대한 URL입니다.

액세스 형식: 읽기/쓰기

데이터 형식 스크립팅: BSTR

// C++ method syntax
HRESULT get_HomePage(
  [out] BSTR* pbstrHomePage
);
HRESULT put_HomePage(
  [in] BSTR bstrHomePage
);

IsAccountLocked

침입자 검색으로 인해 계정이 잠겨 있는지를 나타내는 플래그입니다. 이 속성은 LDAP ADSI 공급자와 함께 사용할 때 사용이 제한됩니다. 이러한 제한 사항에 대한 자세한 내용은 계정 잠금(LDAP 공급자)을 참조하세요.

액세스 형식: 읽기/쓰기

스크립팅 데이터 형식: 부울

// C++ method syntax
HRESULT get_IsAccountLocked(
  [out] VARIANT_BOOL* pfIsAccountLocked
);
HRESULT put_IsAccountLocked(
  [in] VARIANT_BOOL fIsAccountLocked
);

언어

사용자의 BSTR 언어 이름 배열입니다.

액세스 형식: 읽기/쓰기

데이터 형식 스크립팅: VARIANT

// C++ method syntax
HRESULT get_Languages(
  [out] VARIANT* pvLanguages
);
HRESULT put_Languages(
  [in] VARIANT vLanguages
);

LastFailedLogin

마지막으로 실패한 네트워크 로그인의 날짜 및 시간입니다.

액세스 형식: 읽기 전용

스크립팅 데이터 형식: DATE

// C++ method syntax
HRESULT get_LastFailedLogin(
  [out] DATE* pdateLastFailedLogin
);

LastLogin

마지막 네트워크 로그인의 날짜 및 시간입니다.

액세스 형식: 읽기 전용

스크립팅 데이터 형식: DATE

// C++ method syntax
HRESULT get_LastLogin(
  [out] DATE* pdateLastLogin
);

LastLogoff

마지막 네트워크 로그오프 날짜 및 시간입니다.

액세스 형식: 읽기 전용

스크립팅 데이터 형식: DATE

// C++ method syntax
HRESULT get_LastLogoff(
  [out] DATE* pdateLastLogoff
);

LastName

사용자의 성입니다.

액세스 형식: 읽기/쓰기

데이터 형식 스크립팅: BSTR

// C++ method syntax
HRESULT get_LastName(
  [out] BSTR* pbstrLastName
);
HRESULT put_LastName(
  [in] BSTR bstrLastName
);

LoginHours

사용자에 대해 로그온이 허용되는 요일별 기간입니다. 해당 시간 슬롯이 유효한 로그온 시간인지 여부를 나타내는 주별 부울 값 테이블로 표시됩니다. 표현은 공급자 및 디렉터리별입니다.

액세스 형식: 읽기/쓰기

데이터 형식 스크립팅: VARIANT

// C++ method syntax
HRESULT get_LoginHours(
  [out] VARIANT* pvLoginHours
);
HRESULT put_LoginHours(
  [in] VARIANT vLoginHours
);

LoginScript

로그온 스크립트 경로입니다.

액세스 형식: 읽기/쓰기

데이터 형식 스크립팅: BSTR

// C++ method syntax
HRESULT get_LoginScript(
  [out] BSTR* pbstrLoginScript
);
HRESULT put_LoginScript(
  [in] BSTR bstrLoginScript
);

LoginWorkstations

사용자가 로그온할 수 있는 BSTR 데이터 형식의 워크스테이션 주소 또는 이름입니다.

액세스 형식: 읽기/쓰기

데이터 형식 스크립팅: VARIANT

// C++ method syntax
HRESULT get_LoginWorkstations(
  [out] VARIANT* pvLoginWorkstations
);
HRESULT put_LoginWorkstations(
  [in] VARIANT vLoginWorkstations
);

관리자

사용자의 관리자입니다.

액세스 형식: 읽기/쓰기

데이터 형식 스크립팅: BSTR

// C++ method syntax
HRESULT get_Manager(
  [out] BSTR* pbstrManager
);
HRESULT put_Manager(
  [in] BSTR bstrManager
);

MaxLogins

허용되는 동시 로그인 세션 수입니다.

액세스 형식: 읽기/쓰기

스크립팅 데이터 형식: LONG

// C++ method syntax
HRESULT get_MaxLogins(
  [out] LONG* plMaxLogins
);
HRESULT put_MaxLogins(
  [in] LONG lMaxLogins
);

MaxStorage

사용자가 사용할 수 있는 최대 디스크 공간(킬로바이트)입니다.

액세스 형식: 읽기/쓰기

스크립팅 데이터 형식: LONG

// C++ method syntax
HRESULT get_MaxStorage(
  [out] LONG* plMaxStorage
);
HRESULT put_MaxStorage(
  [in] LONG lMaxStorage
);

NamePrefix

사용자의 이름 접두사(예: "Ms.", 또는 "Hon")입니다.

액세스 형식: 읽기/쓰기

데이터 형식 스크립팅: BSTR

// C++ method syntax
HRESULT get_NamePrefix(
  [out] BSTR* pbstrNamePrefix
);
HRESULT put_NamePrefix(
  [in] BSTR bstrNamePrefix
);

NameSuffix

사용자의 이름 접미사(예: "Jr.", 또는 "III")입니다.

액세스 형식: 읽기/쓰기

데이터 형식 스크립팅: BSTR

// C++ method syntax
HRESULT get_NameSuffix(
  [out] BSTR* pbstrNameSuffix
);
HRESULT put_NameSuffix(
  [in] BSTR bstrNameSuffix
);

OfficeLocations

사용자를 위한 BSTR 배열인 Office 위치입니다. Active Directory의 경우 이 속성은 단일 값이며 배열에는 하나의 요소가 있습니다.

액세스 형식: 읽기/쓰기

데이터 형식 스크립팅: VARIANT

// C++ method syntax
HRESULT get_OfficeLocations(
  [out] VARIANT* pvOfficeLocations
);
HRESULT put_OfficeLocations(
  [in] VARIANT vOfficeLocations
);

OtherName

사용자에 대한 추가 이름(예: 중간 이름)입니다.

액세스 형식: 읽기/쓰기

데이터 형식 스크립팅: BSTR

// C++ method syntax
HRESULT get_OtherName(
  [out] BSTR* pbstrOtherName
);
HRESULT put_OtherName(
  [in] BSTR bstrOtherName
);

PasswordExpirationDate

암호가 만료되는 날짜 및 시간입니다.

액세스 형식: 읽기/쓰기

스크립팅 데이터 형식: DATE

// C++ method syntax
HRESULT get_PasswordExpirationDate(
  [out] DATE* pdatePasswordExpirationDate
);
HRESULT put_PasswordExpirationDate(
  [in] DATE datePasswordExpirationDate
);

PasswordLastChanged

암호가 마지막으로 변경된 시간입니다.

액세스 형식: 읽기 전용

스크립팅 데이터 형식: DATE

// C++ method syntax
HRESULT get_PasswordLastChanged(
  [out] DATE* pdatePasswordLastChanged
);

PasswordMinimumLength

암호의 최소 길이입니다.

액세스 형식: 읽기/쓰기

스크립팅 데이터 형식: LONG

// C++ method syntax
HRESULT get_PasswordMinimumLength(
  [out] LONG* plPasswordMinimumLength
);
HRESULT put_PasswordMinimumLength(
  [in] LONG lPasswordMinimumLength
);

PasswordRequired

암호가 필요한지 나타내는 플래그입니다.

액세스 형식: 읽기/쓰기

스크립팅 데이터 형식: 부울

// C++ method syntax
VARIANT_BOOL get_PasswordRequired(
  [out] VARIANT_BOOL* pfPasswordRequired
);
HRESULT put_PasswordRequired(
  [in] VARIANT_BOOL fPasswordRequired
);

그림

이미지를 저장하는 바이트의 OctetString 배열입니다.

액세스 형식: 읽기/쓰기

데이터 형식 스크립팅: VARIANT

// C++ method syntax
HRESULT get_Picture(
  [out] VARIANT* pvarPicture
);
HRESULT put_Picture(
  [in] VARIANT varPicture
);

PostalAddresses

BSTR 배열인 우편 주소입니다. 이 속성은 사용자의 주소보다 많은 값을 보유하기 위해 다중값입니다. PostalAddress의 내부 형식은 X.521-1993에서 참조하는 CCITT F.401을 준수해야 하며, PostalAddress를 각각 30바이트의 6개 요소로 정의하고 주소, (선택 사항) 우체국 Box, 구/군/시, 시/도, 시/도, 우편 번호 및 국가/지역을 보유합니다.

액세스 형식: 읽기/쓰기

데이터 형식 스크립팅: VARIANT

// C++ method syntax
HRESULT get_PostalAddresses(
  [out] VARIANT* pvPostalAddresses
);
HRESULT put_PostalAddresses(
  [in] VARIANT vPostalAddresses
);

PostalCodes

BSTR 배열인 우편 번호입니다. 우편 번호는 PostalAddresses 배열에 위치적으로 연결됩니다. 그러나 Active Directory에서 이 속성은 단일 값이며 배열에는 단일 요소가 있습니다.

액세스 형식: 읽기/쓰기

데이터 형식 스크립팅: VARIANT

// C++ method syntax
HRESULT get_PostalCodes(
  [out] VARIANT* pvPostalCodes
);
HRESULT put_PostalCodes(
  [in] VARIANT vPostalCodes
);

Profile

사용자 프로필의 경로입니다.

액세스 형식: 읽기/쓰기

데이터 형식 스크립팅: BSTR

// C++ method syntax
HRESULT get_Profile(
  [out] BSTR* pbstrProfile
);
HRESULT put_Profile(
  [in] BSTR bstrProfile
);

RequireUniquePassword

새 암호가 암호 기록을 통해 알려진 암호와 달라야 하는지를 나타내는 플래그입니다.

액세스 형식: 읽기/쓰기

스크립팅 데이터 형식: 부울

// C++ method syntax
HRESULT get_RequireUniquePassword(
  [out] VARIANT_BOOL* pfRequireUniquePassword
);
HRESULT put_RequireUniquePassword(
  [in] VARIANT_BOOL fRequireUniquePassword
);

SeeAlso

사용자와 관련된 다른 개체의 ADsPaths 배열입니다.

액세스 형식: 읽기/쓰기

데이터 형식 스크립팅: VARIANT

// C++ method syntax
HRESULT get_SeeAlso(
  [out] VARIANT* pvSeeAlso
);
HRESULT put_SeeAlso(
  [in] VARIANT vSeeAlso
);

TelephoneHome

사용자의 집 전화 번호 배열입니다. Active Directory에서 이 속성은 단일 값이며 배열에는 하나의 요소가 있습니다.

액세스 형식: 읽기/쓰기

데이터 형식 스크립팅: VARIANT

// C++ method syntax
HRESULT get_TelephoneHome(
  [out] VARIANT* pvarTelephoneHome
);
HRESULT put_TelephoneHome(
  [in] VARIANT varTelephoneHome
);

TelephoneMobile

사용자의 휴대폰 번호 배열입니다. Active Directory에서 이 속성은 단일 값이며 배열에는 하나의 요소만 있습니다.

액세스 형식: 읽기/쓰기

데이터 형식 스크립팅: VARIANT

// C++ method syntax
HRESULT get_TelephoneMobile(
  [out] VARIANT* pvarTelephoneMobile
);
HRESULT put_TelephoneMobile(
  [in] VARIANT varTelephoneMobile
);

TelephoneNumber

일반적으로 사용자와 연결된 회사 관련 전화 번호의 배열입니다. Active Directory에서 이 속성은 단일 값이며 배열은 단일 요소입니다.

액세스 형식: 읽기/쓰기

스크립팅 데이터 형식: VARIANT

// C++ method syntax
HRESULT get_TelephoneNumber(
  [out] VARIANT* pvarTelephoneNumber
);
HRESULT put_TelephoneNumber(
  [in] VARIANT varTelephoneNumber
);

TelephonePager

사용자의 호출기 번호 배열입니다. Active Directory에서 이 속성은 단일 값이며 배열은 단일 요소입니다.

액세스 형식: 읽기/쓰기

스크립팅 데이터 형식: VARIANT

// C++ method syntax
HRESULT get_TelephonePager(
  [out] VARIANT* pvarTelephonePager
);
HRESULT put_TelephonePager(
  [in] VARIANT varTelephonePager
);

제목

사용자의 제목입니다.

액세스 형식: 읽기/쓰기

스크립팅 데이터 형식: BSTR

// C++ method syntax
HRESULT get_Title(
  [out] BSTR* pbstrTitle
);
HRESULT put_Title(
  [in] BSTR bstrTitle
);

설명

Microsoft에서 제공하는 WinNT 공급자는 위에서 설명한 대로 모든 IADsUser 속성 메서드를 지원하지 않습니다. 그러나 공급자는 IADs::Get 또는 IADs::P ut 메서드를 사용하여 액세스할 수 있는 다른 속성을 지원합니다. 자세한 내용과 지원되지 않는 속성 및 코드 예제 목록은 ADSI WinNT 공급자의 WinNT 사용자 개체를 참조하세요.

사용자 클래스 개체의 ADSI LDAP 공급자 특정 기능에 대한 자세한 내용은 ADSI LDAP 공급자의 LDAP 사용자 개체를 참조하세요. 이 항목에는 IADsUser와 사용자 계정을 관리하기 위한 코드 예제가 포함되어 있습니다.

예제

다음 코드 예제에서는 사용자 계정 개체에 바인딩하고 사용자의 전체 이름을 검색하는 방법을 보여줍니다.

Dim usr As IADsUser
Dim sFullName as String

On Error GoTo Cleanup
Set usr = GetObject("WinNT://Fabrikam/JeffSmith,user")
sFullName = usr.FullName

Cleanup:
    If (Err.Number<>0) Then
        MsgBox("An error has occurred. " & Err.Number)
    End If

    Set usr = Nothing

다음 코드 예제에서는 사용자 계정 개체에 바인딩하고 사용자의 전체 이름을 검색하는 방법을 보여줍니다.

IADsUser *GetUserObject(LPWSTR uPath)
{
    IADsUser *pUser;
    HRESULT hr = ADsGetObject(uPath,IID_IADsUser,(void**)&pUser);
    if (FAILED(hr)) {return NULL;}
    BSTR bstr;
    hr = pUser->get_FullName(&bstr);
    printf("User: %S\n", bstr);
    SysFreeString(bstr);
    return pUser;
}

요구 사항

요구 사항 값
지원되는 최소 클라이언트
 Windows Vista
지원되는 최소 서버
 Windows Server 2008
헤더
Iads.h
DLL
Activeds.dll
IID
 IID_IADsUser 3E37E320-17E2-11CF-ABC4-02608C9E7553으로 정의됩니다.

추가 정보

IADsUser

Interface 속성 메서드

IADs::Get

IADs::P ut

WinNT 사용자 개체

ADSI WinNT 공급자

LDAP 사용자 개체

ADSI LDAP 공급자