Метод 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;
}

Требования

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

Коды ошибок ADSI

IADsExtension