IADsExtension::Operate-Methode (iads.h)

Die IADsExtension::Operate-Methode wird vom Aggregator aufgerufen, um die erweiterte Funktionalität auszuführen. Die -Methode interpretiert den Steuerungscode und die Eingabeparameter gemäß den Spezifikationen des Anbieters. Weitere Informationen finden Sie in der Anbieterdokumentation.

Syntax

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

Parameter

[in] dwCode

Ein Wert des ADSI-Erweiterungssteuerelementcodes. ADSI definiert den folgenden Codewert.

ADS_EXT_INITCREDENTIALS

Überprüft Benutzeranmeldeinformationen im Erweiterungsobjekt.

[in] varData1

Vom Anbieter bereitgestellte Daten, mit denen das Erweiterungsobjekt ausgeführt wird. Der Wert hängt vom Steuerelementcodewert ab und ist derzeit nicht definiert.

[in] varData2

Vom Anbieter bereitgestellte Daten, mit denen das Erweiterungsobjekt ausgeführt wird. Der Wert hängt vom Steuerelementcodewert ab und ist derzeit nicht definiert.

[in] varData3

Vom Anbieter bereitgestellte Daten, mit denen das Erweiterungsobjekt ausgeführt wird. Der Wert hängt vom Steuerelementcodewert ab und ist derzeit nicht definiert.

Rückgabewert

Diese Methode unterstützt die Standardrückgabewerte sowie Folgendes:

Weitere Informationen zu anderen Rückgabewerten finden Sie unter ADSI-Fehlercodes.

Hinweise

Der Aggregator ignoriert die E_FAIL und E_NOTIMPL Rückgabewerte.

Beispiele

Das folgende C/C++-Codebeispiel zeigt eine generische Implementierung.

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	iads.h
DLL	Activeds.dll

Weitere Informationen

ADSI-Fehlercodes

IADsExtension