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
Winutil.h (include Streams.h)
Bibliothek
Strmbase.lib (Verkaufsbuilds);
Strmbasd.lib (Debugbuilds)

Weitere Informationen

CCmdQueue-Klasse