Métodos de propiedad IADsGroup

Los métodos de propiedad de la interfaz IADsGroup leen y escriben las siguientes propiedades. Para obtener más información, vea Interface Property Methods.

Propiedades

Descripción

Indica la descripción textual de la pertenencia a grupos.

Tipo de acceso: lectura/escritura

Tipo de datos de scripting: BSTR

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

Comentarios

Uso de IADsGroup para recuperar descripciones de grupos integrados

En los ejemplos siguientes se muestra cómo recuperar información sobre los objetos de grupo de Windows por nombre. En un entorno multilingüe, los grupos integrados a veces se conocen por nombres localizados diferentes, lo que significa que no se pueden recuperar directamente mediante identificadores de cadena como "WinNT://Microsoft/Administrators". En ese caso, el usuario puede enlazar al objeto SID conocido para el grupo, recuperar el nombre del grupo localizado y proporcionarlo al método GetObject. Para obtener más información, consulte SID conocidos.

Ejemplos

En el siguiente ejemplo de Visual Basic se muestra cómo enlazar a un objeto de grupo y mostrar la descripción del 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

En el siguiente ejemplo de C++ se muestra cómo enlazar a un objeto de grupo y mostrar la descripción del 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	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Encabezado	Iads.h
Archivo DLL	Activeds.dll
IID	IID_IADsGroup se define como 27636B00-410F-11CF-B1FF-02608C9E7553

Consulte también

Iads

IADsGroup

Métodos de propiedad interface