Поделиться через


Методы свойств IADsUser

Методы свойств интерфейса IADsUser получают или задают свойства, описанные в следующей таблице. Дополнительные сведения см. в разделе Методы свойств интерфейса.

Свойства

AccountDisabled

Флаг, указывающий, отключена ли учетная запись или должна быть отключена.

Тип доступа: чтение и запись

Тип данных скрипта: Boolean

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

Отдел

Подразделение в компании или организации.

Тип доступа: чтение и запись

Тип данных скрипта: 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
);

FaxNumber

Номер факса или номера пользователя. В 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).

Тип доступа: чтение и запись

Тип данных скрипта: Boolean

// 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

Расположение Office в виде массива BSTR для пользователя. Для Active Directory это свойство имеет одно значение, а массив содержит один элемент.

Тип доступа: чтение и запись

Тип данных скрипта: VARIANT

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

Другое Имя

Дополнительное имя, например отчество, для пользователя.

Тип доступа: чтение и запись

Тип данных скрипта: 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

Флаг, указывающий, требуется ли пароль.

Тип доступа: чтение и запись

Тип данных скрипта: Boolean

// 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 . Это свойство имеет многозначное значение, чтобы вместить больше адресов пользователя. Внутренний формат PostAddress должен соответствовать CCITT F.401, как указано в X.521-1993, который определяет PostalAddress как шесть элементов по 30 байт каждый, содержащий почтовый адрес(необязательно) почтовый ящик, город или населенный пункт, штат или провинция, почтовый индекс и страна/регион.

Тип доступа: чтение и запись

Тип данных скрипта: VARIANT

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

Почтовые индексы

Почтовые индексы в виде массива BSTR . Почтовые индексы позиционально связаны с массивом PostalAddresses . Однако в Active Directory это свойство имеет одно значение, а массив содержит один элемент.

Тип доступа: чтение и запись

Тип данных скрипта: VARIANT

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

Профиль

Путь к профилю пользователя.

Тип доступа: чтение и запись

Тип данных скрипта: BSTR

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

RequireUniquePassword

Флаг, указывающий, должен ли новый пароль отличаться от паролей, известных в журнале паролей.

Тип доступа: чтение и запись

Тип данных скрипта: Boolean

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

См. раздел

Массив ADsPaths других объектов, связанных с пользователем.

Тип доступа: чтение и запись

Тип данных скрипта: VARIANT

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

ТелефонГлавная

Массив номеров домашних телефонов пользователя. В Active Directory это свойство имеет одно значение, а массив содержит один элемент.

Тип доступа: чтение и запись

Тип данных скрипта: VARIANT

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

ТелефонМобиль

Массив номеров мобильных телефонов пользователя. В Active Directory это свойство имеет одно значение, а массив имеет только один элемент.

Тип доступа: чтение и запись

Тип данных скрипта: VARIANT

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

Номер телефона

Массив номеров телефонов, обычно связанных с работой, связанных с пользователем. В 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
);

Комментарии

Поставщик WinNT, предоставленный корпорацией Майкрософт, не поддерживает все методы свойств IADsUser , как показано выше. Однако поставщик поддерживает другие свойства, доступ к которым можно получить с помощью метода IADs::Get или IADs::P ut . Дополнительные сведения и список неподдерживаемых свойств и примеров кода см. в разделе Объект пользователя WinNT в поставщике WINNT ADSI.

Дополнительные сведения о функциях, характерных для поставщика ADSI LDAP объекта класса пользователя, см. в статье Ldap User Object in ADSI LDAP Provider. Этот раздел содержит 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

Методы свойств интерфейса

IADs::Get

IADs::P ut

Объект пользователя WinNT

Поставщик ADSI WinNT

Объект пользователя LDAP

Поставщик LDAP ADSI