IPipeByte::P ull-Methode (objidl.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 in der Lage sein, mindestens die in cRequest angegebene Anzahl von Bytes aufzunehmen.
[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 Anzahl von Bytes enthält, die im cRequest-Parameter angegeben sind. 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 0 ist, gibt dies an, dass keine weiteren Daten vorhanden sind.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | objidl.h (include ObjIdl.h) |