IPipeByte::P ull-Methode (objidlbase.h)

Ruft Daten des Bytetyps aus der Pipequelle ab.

Syntax

HRESULT Pull(
  [out] BYTE  *buf,
  [in]  ULONG cRequest,
  [out] ULONG *pcReturned
);

Parameter

[out] buf

Ein Zeiger auf den Speicherpuffer, der die Daten empfängt. Der Puffer muss mindestens die in cRequest angegebene Anzahl von Bytes enthalten können.

[in] cRequest

Die Anzahl der angeforderten Bytes.

[out] pcReturned

Die tatsächliche Anzahl der zurückgegebenen Bytes.

Rückgabewert

Diese Methode gibt S_OK zurück, um anzugeben, dass die Daten erfolgreich abgerufen wurden.

Hinweise

Wenn die Pull-Methode aufgerufen wird, werden Daten vom Anbieter der Pipe angefordert. Der Aufrufer muss einen Puffer bereitstellen, der mindestens die im cRequest-Parameter angegebene Anzahl von Bytes enthält. Der Proxy hebt die Daten im bereitgestellten Puffer auf und legt die Anzahl der Bytes fest, die tatsächlich in pcReturned bereitgestellt werden. Der parameter pcReturned kann kleiner oder gleich cRequest sein, aber er wird nie größer sein. Wenn pcReturned den Wert 0 aufweist, gibt dies an, dass keine Weiteren Daten vorhanden sind.

Anforderungen

Weitere Informationen

IPipeByte