IADsGroup プロパティ メソッド

IADsGroup インターフェイスのプロパティ メソッドは、次のプロパティの読み取りと書き込みを行います。 詳細については、「インターフェイス プロパティ メソッド」を参照してください。

プロパティ

説明

グループ メンバーシップの説明テキストを示します。

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

スクリプト データ型: BSTR

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

解説

IADsGroup を使用して組み込みグループの説明を取得する

次の例は、Windows グループ オブジェクトに関する情報を名前で取得する方法を示しています。 多言語環境では、組み込みグループはローカライズされた異なる名前で認識されることがあります。つまり、"WinNT://Microsoft/管理istrators" などの文字列識別子を使用して直接取得することはできません。 その場合、ユーザーはグループの既知の SID オブジェクトにバインドし、ローカライズされたグループ名を取得し、それを GetObject メソッドに指定できます。 詳細については、既知の SID を参照してください。

例

次の Visual Basic の例は、グループ オブジェクトにバインドし、グループの説明を表示する方法を示しています。

Dim grp As IADsGroup
On Error GoTo Cleanup

Set grp = GetObject("WinNT://Microsoft/Administrators")
Debug.Print grp.Description

Cleanup
    If (Err.Number<>0) Then
        MsgBox("An error has occurred. " & Err.Number)
    End If
    Set grp = Nothing

次の C++ の例は、グループ オブジェクトにバインドし、グループの説明を表示する方法を示しています。

IADsGroup *pGroup = NULL;
HRESULT hr = S_OK;
LPWSTR adsPath = L"WinNT://localHost/Administrators";
BSTR bstr;

hr = ADsGetObject(adsPath,IID_IADsGroup,(void**)&pGroup);

if(FAILED(hr)) {goto Cleanup;}

hr = pGroup->get_Description(&bstr);
if(FAILED(hr)) {goto Cleanup;}

printf("Description: %S\n",bstr);

Cleanup:
    SysFreeString(bstr);
    if(pGroup) 
        pGroup->Release();

    return hr;

要件

関連項目

Iad

IADsGroup

Interface プロパティ メソッド