Fungsi ADsPropGetInitInfo (adsprop.h)

Artikel
02/26/2024

Fungsi ADsPropGetInitInfo digunakan untuk mendapatkan data objek direktori tempat ekstensi lembar properti Active Directory Domain Services berlaku.

Sintaks

BOOL ADsPropGetInitInfo(
  [in]  HWND               hNotifyObj,
  [out] PADSPROPINITPARAMS pInitParams
);

Parameter

[in] hNotifyObj

Handel objek pemberitahuan. Untuk mendapatkan handel ini, panggil ADsPropCreateNotifyObj.

[out] pInitParams

Arahkan ke struktur ADSPROPINITPARAMS yang menerima data objek direktori. Anggota dwSize dari struktur ini harus dimasukkan sebelum memanggil fungsi ini.

Nilai kembali

Mengembalikan bukan nol jika berhasil atau nol sebaliknya.

Keterangan

Memori untuk anggota pwzCN dan pWritableAttrs dialokasikan oleh fungsi ADsPropGetInitInfo . Memori ini dibebaskan oleh sistem setelah semua objek lembar properti dihancurkan. Jumlah referensi untuk penunjuk antarmuka di pDsObj tidak bertambah dengan memanggil ADsPropGetInitInfo, sehingga antarmuka tidak boleh dirilis oleh pemanggil.

Untuk lembar properti beberapa pilihan, sistem hanya mengikat ke objek pertama dalam array DSOBJECT . Karena itu, ADsPropGetInitInfo hanya memasok atribut IDirectoryObject dan bisa-tulis untuk objek pertama dalam array. Objek lain dalam array tidak terikat.

Contoh

Contoh kode berikut menunjukkan cara menggunakan fungsi ADsPropGetInitInfo .

HRESULT GetADsPageInfo(HWND hwndNotifyObject, ADSPROPINITPARAMS *pip)
{
    if((NULL == pip) || (!IsWindow(hwndNotifyObject)))
    {
        return E_INVALIDARG;
    }

    ADSPROPINITPARAMS   InitParams;
    
    InitParams.dwSize = sizeof(ADSPROPINITPARAMS);
    if(ADsPropGetInitInfo(hwndNotifyObject, &InitParams))
    {
        *pip = InitParams;
    
        return InitParams.hr;
    }
    
    return E_FAIL;
}

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Target Platform	Windows
Header	adsprop.h
Pustaka	Dsprop.lib
DLL	Dsprop.dll

Lihat juga

ADSPROPINITPARAMS

ADsPropCreateNotifyObj

Bagikan melalui