CCmdQueue.New-Methode
Die New -Methode initialisiert einen auszuführenden Befehl und gibt ein neues CDeferredCommand-Objekt zurück.
Syntax
virtual HRESULT New(
CDeferredCommand **ppCmd,
LPUNKNOWN pUnk,
REFTIME time,
GUID *iid,
long dispidMethod,
short wFlags,
long cArgs,
VARIANT *pDispParams,
VARIANT *pvarResult,
short *puArgErr,
BOOL bStream
);
Parameter
-
ppCmd
-
Adresse eines Zeigers auf ein CDeferredCommand-Objekt, mit dem eine Anwendung den Befehl abbrechen, eine neue Präsentationszeit dafür festlegen oder Schätzungsinformationen abrufen kann.
-
Punk
-
Zeiger auf das Objekt, das den Befehl ausführen soll.
-
time
-
Zeitpunkt, zu dem der Befehl oder die Befehle in der Warteschlange ausgeführt werden sollen.
-
Iid
-
Zeiger auf den global eindeutigen Bezeichner (GUID) der aufzurufenden Schnittstelle.
-
dispidMethod
-
Die -Methode für die -Schnittstelle, die aufgerufen werden soll.
-
wFlags
-
Flags, die den Kontext des Aufrufs beschreiben. Dieser Parameter unterstützt die gleichen Flags wie die IDispatch::Invoke-Methode.
-
cArgs
-
Anzahl der übergebenen Argumente.
-
pDispParams
-
Zeiger auf die Liste der Variantentypen, die den Dispatchparametern zugeordnet sind.
-
pvarResult
-
Zeiger auf die Liste, in der Ggf. Ergebnisse zurückgegeben werden sollen.
-
puArgErr
-
Zeiger auf den Index in der pDispParams-Parameterliste, an dem der letzte Fehler aufgetreten ist.
-
bStream
-
Wert, der angibt, ob der Time-Parameter ein Streamzeitwert (TRUE) oder ein Präsentationszeitwert (FALSE) ist.
Rückgabewert
Gibt bei Erfolg S _ OK zurück. Gibt E _ OUTOFMEMORY zurück, wenn ppCmd vom Erstellen des neuen CDeferredCommand-Objekts mit dem Wert NULL zurückgibt. Andernfalls gibt ein HRESULT zurück, das einen Fehler beim Erstellen eines neuen CDeferredCommand-Objekts angibt. Wenn ein Fehler auftritt, wurde kein Objekt in die Warteschlange eingereiht.
Hinweise
Das neue CDeferredCommand-Objekt wird mit den Parametern initialisiert und während der Erstellung der Warteschlange hinzugefügt. Diese Methode ähnelt der IDispatch::Invoke-Methode.
Die Werte für den wFlags-Parameter umfassen Folgendes:
| Wert | Beschreibung |
|---|---|
| _DISPATCH-METHODE | Der Member wird als Methode ausgeführt. Wenn eine Eigenschaft den gleichen Namen hat, können sowohl dieses als auch das DISPATCH _ PROPERTYGET-Flag festgelegt werden. |
| DISPATCH _ PROPERTYGET | Der Member wird als Eigenschafts- oder Datenmember abgerufen. |
| DISPATCH _ PROPERTYPUT | Der Member wird als Eigenschafts- oder Datenmember geändert. |
| DISPATCH _ PROPERTYPUTREF | Der Member wird nicht über eine Wertzuweisung, sondern über eine Verweiszuweisung geändert. Dieser Wert ist nur gültig, wenn die -Eigenschaft einen Verweis auf ein -Objekt akzeptiert. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Header |
|
| Bibliothek |
|