Métodos de propriedade IADsGroup

Os métodos de propriedade da interface IADsGroup leem e gravam as propriedades a seguir. Para obter mais informações, consulte Métodos de propriedade de interface.

Propriedades

Descrição

Indica a descrição textual da associação de grupo.

Tipo de acesso: leitura/gravação

Tipo de dados de script: BSTR

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

Comentários

Usando IADsGroup para recuperar descrições de grupos internos

Os exemplos a seguir mostram como recuperar informações sobre objetos de grupo do Windows por nome. Em um ambiente multilíngue, grupos internos às vezes são conhecidos por nomes localizados diferentes, o que significa que eles não podem ser recuperados diretamente usando identificadores de cadeia de caracteres, como "WinNT://Microsoft/Administrators". Nesse caso, o usuário pode associar ao objeto SID conhecido do grupo, recuperar o nome do grupo localizado e fornecê-lo ao método GetObject. Para obter mais informações, consulte SIDs conhecidos.

Exemplos

O exemplo do Visual Basic a seguir mostra como associar a um objeto de grupo e exibir a descrição do grupo.

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

O exemplo C++ a seguir mostra como associar a um objeto de grupo e exibir a descrição do grupo.

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;

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Cabeçalho	Iads.h
DLL	Activeds.dll
IID	IID_IADsGroup é definido como 27636B00-410F-11CF-B1FF-02608C9E7553

Confira também

Iads

IADsGroup

Métodos de propriedade interface