Metodo IPipeByte::P ull (objidlbase.h)

Articolo
03/05/2024

Recupera i dati del tipo di byte dall'origine della pipe.

Sintassi

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

Parametri

[out] buf

Puntatore al buffer di memoria che riceve i dati. Il buffer deve essere in grado di contenere almeno il numero di byte specificati in cRequest.

[in] cRequest

Numero di byte richiesti.

[out] pcReturned

Numero effettivo di byte restituiti.

Valore restituito

Questo metodo restituisce S_OK per indicare che i dati sono stati recuperati correttamente.

Commenti

Quando viene chiamato il metodo Pull , i dati vengono richiesti dal provider della pipe. Il chiamante deve fornire un buffer che conterrà almeno il numero di byte specificato nel parametro cRequest . Il proxy annulla ilmarshaling dei dati nel buffer fornito e imposta il numero di byte effettivamente forniti in pcReturned. Il parametro pcReturned può essere minore o uguale a cRequest, ma non sarà mai maggiore. Quando pcReturned è 0, indica che non sono presenti altri dati.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	objidlbase.h (include ObjIdl.h)

Vedi anche

IPipeByte

Condividi tramite