CreateStdDispatch
Dieser Dokumentation für die Vorschau nur ist und in späteren Versionen geändert. Leere Themen wurden als Platzhalter eingefügt.]
Erstellt eine Standardimplementierung der IDispatch-Schnittstelle durch einen Aufruf einzelne Funktion. Dies vereinfacht die Kennzeichnung Objekte über die Automatisierung.
HRESULT CreateStdDispatch(
IUnknown FAR* punkOuter,
void FAR* pvThis,
ITypeInfo FAR* ptinfo,
IUnknown FAR* FAR* ppunkStdDisp
);
Parameter
punkOuter
Zeiger auf das Objekt IUnknown Implementierung.pvThis
Zeiger auf das Objekt um verfügbar zu machen.ptinfo
Zeiger auf die Typinformationen, die offen gelegte Objekt beschreibt.ppunkStdDisp
Dies ist die private unbekannte für das Objekt, das die IDispatch Schnittstelle Aufruf von QueryInterface implementiert. This-Zeiger ist NULL, wenn die Funktion fehlschlägt.
Rückgabewert
Der Rückgabewert vom zurückgegebenen HRESULT ist eine der folgenden:
Rückgabewert |
Bedeutung |
|---|---|
S_OK |
Erfolg. |
E_INVALIDARG |
Einer der ersten drei Argumente ist ungültig. |
E_OUTOFMEMORY |
Nicht genügend Arbeitsspeicher, um den Vorgang abzuschließen. |
Kommentare
CreateStdDispatch können beim Erstellen eines Objekts statt die IDispatch Memberfunktionen für das Objekt zu implementieren. Die Implementierung erstellt jedoch, dass CreateStdDispatch unterliegt folgenden Einschränkungen:
Nur eine nationale Sprache unterstützt.
Unterstützt nur Dispatch-definierte Ausnahme Codes von Invoke zurückgegeben.
LoadTypeLib GetTypeInfoOfGuidund CreateStdDispatch umfassen den minimalen Satz von Funktionen, die Sie aufrufen, um ein Objekt mit einer Bibliothek Typ offen legen müssen. Weitere Informationen zum LoadTypeLib und GetTypeInfoOfGuidfinden Sie unter Typ Beschreibung Schnittstellen.
CreateDispTypeInfo und CreateStdDispatch umfassen den minimalen Satz von Dispatch Komponenten, die Sie aufrufen, um ein Objekt mit der Struktur INTERFACEDATA bereitgestellten Typ Informationen offen legen müssen.
Beispiel
Der folgende Code implementiert die IDispatch Schnittstelle für die CCalc Klasse von CreateStdDispatch .
CCalc FAR*
CCalc::Create()
{
HRESULT hresult;
CCalc FAR* pcalc;
CArith FAR* parith;
ITypeInfo FAR* ptinfo;
IUnknown FAR* punkStdDisp;
extern INTERFACEDATA NEARDATA g_idataCCalc;
if((pcalc = new FAR CCalc()) == NULL)
return NULL;
pcalc->AddRef();
parith = &(pcalc->m_arith);
// Build type information for the functionality on this object that
// is being exposed for external programmability.
hresult = CreateDispTypeInfo(
&g_idataCCalc, LOCALE_SYSTEM_DEFAULT, &ptinfo);
if(hresult != NOERROR)
goto LError0;
// Create an aggregate with an instance of the default
// implementation of IDispatch that is initialized with
// type information.
hresult = CreateStdDispatch(
pcalc, // Controlling unknown.
parith, // Instance to dispatch on.
ptinfo, // Type information describing the instance.
&punkStdDisp);
ptinfo->Release();
if(hresult != NOERROR)
goto LError0;
pcalc->m_punkStdDisp = punkStdDisp;
return pcalc;
LError0:;
pcalc->Release();
return NULL;
}