Método IADsExtension::Operate (iads.h)

O método IADsExtension::Operate é invocado pelo agregador para executar a funcionalidade estendida. O método interpreta o código de controle e os parâmetros de entrada de acordo com as especificações do provedor. Para obter mais informações, consulte a documentação do provedor.

Sintaxe

HRESULT Operate(
  [in] DWORD   dwCode,
  [in] VARIANT varData1,
  [in] VARIANT varData2,
  [in] VARIANT varData3
);

Parâmetros

[in] dwCode

Um valor do código de controle de extensão ADSI. ADSI define o valor de código a seguir.

ADS_EXT_INITCREDENTIALS

Verifica as credenciais do usuário no objeto de extensão.

[in] varData1

Dados fornecidos pelo provedor nos quais o objeto de extensão funcionará. O valor depende do valor do código de controle e, no momento, é indefinido.

[in] varData2

Dados fornecidos pelo provedor nos quais o objeto de extensão funcionará. O valor depende do valor do código de controle e, no momento, é indefinido.

[in] varData3

Dados fornecidos pelo provedor nos quais o objeto de extensão funcionará. O valor depende do valor do código de controle e, no momento, é indefinido.

Retornar valor

Esse método dá suporte aos valores retornados padrão, bem como aos seguintes:

Para obter mais informações sobre outros valores retornados, consulte Códigos de erro ADSI.

Comentários

O agregador ignorará os valores retornados E_FAIL e E_NOTIMPL .

Exemplos

O exemplo de código C/C++ a seguir mostra uma implementação genérica.

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;
}

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Plataforma de Destino	Windows
Cabeçalho	iads.h
DLL	Activeds.dll

Confira também

Códigos de erro ADSI

IADsExtension