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 |