Метод IADsExtension::Operate (iads.h)
Метод IADsExtension::Operate вызывается агрегатором для выполнения расширенных функций. Метод интерпретирует код элемента управления и входные параметры в соответствии со спецификациями поставщика. Дополнительные сведения см. в документации по поставщику.
Синтаксис
HRESULT Operate(
[in] DWORD dwCode,
[in] VARIANT varData1,
[in] VARIANT varData2,
[in] VARIANT varData3
);
Параметры
[in] dwCode
Значение кода элемента управления расширения ADSI. ADSI определяет следующее значение кода.
ADS_EXT_INITCREDENTIALS
Проверяет учетные данные пользователя в объекте расширения.
[in] varData1
Предоставленные поставщиком данные, с которыми будет работать объект расширения. Значение зависит от значения кода элемента управления и в настоящее время не определено.
[in] varData2
Предоставленные поставщиком данные, с которыми будет работать объект расширения. Значение зависит от значения кода элемента управления и в настоящее время не определено.
[in] varData3
Предоставленные поставщиком данные, с которыми будет работать объект расширения. Значение зависит от значения кода элемента управления и в настоящее время не определено.
Возвращаемое значение
Этот метод поддерживает стандартные возвращаемые значения, а также следующие:
Дополнительные сведения о других возвращаемых значениях см. в разделе Коды ошибок ADSI.
Комментарии
Агрегатор игнорирует E_FAIL и E_NOTIMPL возвращаемые значения.
Примеры
В следующем примере кода C/C++ показана универсальная реализация.
STDMETHOD(Operate)(ULONG dwCode, VARIANT varData1, VARIANT varData2, VARIANT varData3)
{
HRESULT hr = S_OK;
switch (dwCode)
{
case ADS_EXT_INITCREDENTIALS:
// Prompt for a credential.
// MessageBox(NULL, "INITCRED", "ADsExt", MB_OK);
break;
default:
hr = E_FAIL;
break;
}
return hr;
}
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista |
| Минимальная версия сервера | Windows Server 2008 |
| Целевая платформа | Windows |
| Header | iads.h |
| DLL | Activeds.dll |