Функция ADsPropGetInitInfo (adsprop.h)

Статья
08/22/2023

Функция ADsPropGetInitInfo используется для получения данных объекта каталога, к которым применяется расширение страницы свойств доменные службы Active Directory.

Синтаксис

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

Параметры

[in] hNotifyObj

Дескриптор объекта уведомления. Чтобы получить этот дескриптор, вызовите ADsPropCreateNotifyObj.

[out] pInitParams

Указатель на структуру ADSPROPINITPARAMS , которая получает данные объекта каталога. Перед вызовом этой функции необходимо ввести член dwSize этой структуры.

Возвращаемое значение

Возвращает ненулевое значение в случае успешного выполнения или ноль в противном случае.

Память для членов pwzCN и pWritableAttrs выделяется функцией ADsPropGetInitInfo . Эта память освобождается системой после уничтожения всех объектов страниц свойств. Число ссылок для указателя интерфейса в pDsObj не увеличивается путем вызова ADsPropGetInitInfo, поэтому вызывающий объект не должен освобождать интерфейс.

Для листов свойств с множественным выбором система привязывается только к первому объекту в массиве DSOBJECT . Из-за этого ADsPropGetInitInfo предоставляет только атрибуты IDirectoryObject и доступные для записи атрибуты для первого объекта в массиве. Другие объекты в массиве не привязаны к .

Примеры

В следующем примере кода показано, как использовать функцию 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;
}

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	adsprop.h
Библиотека	Dsprop.lib
DLL	Dsprop.dll

См. также раздел

ADSPROPINITPARAMS

ADsPropCreateNotifyObj

Поделиться через