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 |