IADsUser プロパティ メソッド

IADsUser インターフェイスのプロパティ メソッドは、次の表で説明するプロパティを取得または設定します。 詳細については、「 Interface プロパティ メソッド」を参照してください。

プロパティ

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

FaxNumber

ユーザーの FAX 番号 (番号)。 Active Directory では、このプロパティは単一値であり、 VARIANT 配列には 1 つの要素があります。

アクセスの種類: 読み取り/書き込み

スクリプト データ型: 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
);

Languages

ユーザーの 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 の場合、このプロパティは単一値であり、配列には 1 つの要素があります。

アクセスの種類: 読み取り/書き込み

スクリプト データ型: 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 つの要素として定義し、番地、(必要に応じて) Office Box、市区町村、都道府県、郵便番号、国/地域を保持します。

アクセスの種類: 読み取り/書き込み

スクリプト データ型: VARIANT

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

PostalCodes

BSTR 配列としての郵便番号。 郵便番号は、 PostalAddresses 配列に位置的にリンクされます。 ただし、Active Directory では、このプロパティは単一値であり、配列には 1 つの要素があります。

アクセスの種類: 読み取り/書き込み

スクリプト データ型: 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

新しいパスワードをパスワード履歴で知られているパスワードと異なる必要があるかどうかを示すフラグ。

アクセスの種類: 読み取り/書き込み

スクリプト データ型: ブール値

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

SeeAlso

ユーザーに関連する他のオブジェクトの ADsPath の配列。

アクセスの種類: 読み取り/書き込み

スクリプト データ型: VARIANT

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

TelephoneHome

ユーザーの自宅電話番号の配列。 Active Directory では、このプロパティは単一値であり、配列には 1 つの要素があります。

アクセスの種類: 読み取り/書き込み

スクリプト データ型: VARIANT

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

TelephoneMobile

ユーザーの携帯電話番号の配列。 Active Directory では、このプロパティは単一値であり、配列には要素が 1 つだけ含まれます。

アクセスの種類: 読み取り/書き込み

スクリプト データ型: VARIANT

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

TelephoneNumber

ユーザーに関連付けられている、通常は仕事に関連する電話番号の配列。 Active Directory では、このプロパティは単一値で、配列は 1 つの要素です。

アクセスの種類: 読み取り/書き込み

スクリプト データ型: VARIANT

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

TelephonePager

ユーザーのポケットベル番号の配列。 Active Directory では、このプロパティは単一値で、配列は 1 つの要素です。

アクセスの種類: 読み取り/書き込み

スクリプト データ型: 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;
}

必要条件

関連項目

IADsUser

Interface プロパティ メソッド

IADs::Get

IADs::P ut

WinNT ユーザー オブジェクト

ADSI WinNT プロバイダー

LDAP ユーザー オブジェクト

ADSI LDAP プロバイダー