IADsCollection::Metode GetObject (iads.h)

2023-08-24

Metode IADsCollection::GetObject mengambil item koleksi.

Sintaks

HRESULT GetObject(
  [in] BSTR    bstrName,
  [in] VARIANT *pvItem
);

Parameter

[in] bstrName

String Unicode yang dihentikan null yang menentukan nama item. Ini adalah nama yang sama yang diteruskan ke IADsCollection::Tambahkan saat item ditambahkan ke koleksi.

[in] pvItem

Nilai item saat ini. Untuk objek, ini sesuai dengan penunjuk antarmuka IDispatch pada objek .

Menampilkan nilai

Metode ini mendukung nilai pengembalian standar, termasuk S_OK. Untuk informasi selengkapnya dan nilai pengembalian lainnya, lihat Kode Kesalahan ADSI.

Keterangan

Jika Anda mengetahui nama sesi dalam koleksi Sesi , panggil metode IADsCollection::GetObject secara eksplisit untuk mengambil objek sesi.

Contoh

Contoh kode Visual Basic berikut menunjukkan cara mengambil objek sesi bernama dari kumpulan sesi layanan file aktif.

Dim fso As IADsFileServiceOperations 
Dim ses As IADsSession
Dim coll As IADsCollection
Dim mySessionName As String

Set fso = GetObject("WinNT://myComputer/FabrikamServer") 
Set coll = fso.Sessions

' Insert code to set mySessionName to the name of mySession.
 
' The following statement invokes IADsCollection::GetObject.
Set ses = coll.GetObject(mySessionName)

Contoh kode C++ berikut menunjukkan cara mengambil objek sesi bernama dari kumpulan sesi layanan file aktif.

HRESULT GetASessionObjectFromCollection(BSTR mySession)
{
    LPWSTR adspath = L"WinNT://myComputer/FabrikamServer";
    IUnknown *pUnk=NULL;
    HRESULT hr = S_OK;
    IADsCollection *pColl = NULL;
    IADsFileServiceOperations *pFso = NULL;
    IADs *pADsObj = NULL;
    VARIANT varObj;
    BSTR bstrObj = NULL;

    VariantInit(&varObj);
    hr = ADsGetObject(adspath, 
                      IID_IADsFileServiceOperations,
                      (void**)&pFso);
    if(FAILED(hr)) {goto Cleanup;}

    hr = pFso->Sessions(&pColl);
    if(FAILED(hr)) {goto Cleanup;}

    hr = pColl->GetObject(mySession, &varObj);
    V_DISPATCH(&varObj)->QueryInterface(IID_IADs,(void**)&pADsObj);
    hr = pADsObj->get_Class(&bstrObj);
    printf("Class of the object obtained from GetObject: %S\n",
             bstrObj);

Cleanup:
    if(bstrObj) SysFreeString(bstrObj);
    if(pFso) pFso->Release();
    VariantClear(&varObj);
    if(pADsObj) pADsObj->Release();
    if(pColl) pColl->Release();

    return hr;
}

Persyaratan


Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Target Platform	Windows
Header	iads.h
DLL	Activeds.dll