Public Member Functions | List of all members
grpc::internal::CompletionQueueTag Class Referenceabstract

An interface allowing implementors to process and filter event tags. More...

#include <completion_queue_tag.h>

Inheritance diagram for grpc::internal::CompletionQueueTag:
Inheritance graph
[legend]

Public Member Functions

virtual bool FinalizeResult (void **tag, bool *status)=0
 
virtual ~CompletionQueueTag ()
 

Detailed Description

An interface allowing implementors to process and filter event tags.

Definition at line 28 of file grpcpp/impl/codegen/completion_queue_tag.h.

Constructor & Destructor Documentation

◆ ~CompletionQueueTag()

virtual grpc::internal::CompletionQueueTag::~CompletionQueueTag ( )
inlinevirtual

Definition at line 30 of file grpcpp/impl/codegen/completion_queue_tag.h.

Member Function Documentation

◆ FinalizeResult()

virtual bool grpc::internal::CompletionQueueTag::FinalizeResult ( void **  tag,
bool status 
)
pure virtual

FinalizeResult must be called before informing user code that the operation bound to the underlying core completion queue tag has completed. In practice, this means:

  1. For the sync API - before returning from Pluck
  2. For the CQ-based async API - before returning from Next
  3. For the callback-based API - before invoking the user callback

This is the method that translates from core-side tag/status to C++ API-observable tag/status.

The return value is the status of the operation (returning status is the general behavior of this function). If this function returns false, the tag is dropped and not returned from the completion queue: this concept is for events that are observed at core but not requested by the user application (e.g., server shutdown, for server unimplemented method responses, or for cases where a server-side RPC doesn't have a completion notification registered using AsyncNotifyWhenDone)

Implemented in grpc::ServerInterface::GenericAsyncRequest, grpc::ServerInterface::PayloadAsyncRequest< Message >, grpc::ServerInterface::RegisteredAsyncRequest, grpc::ServerInterface::BaseAsyncRequest, grpc::ServerContextBase::CompletionOp, grpc::internal::AlarmImpl, grpc::Server::SyncRequest, and grpc::testing::PhonyTag.


The documentation for this class was generated from the following file:


grpc
Author(s):
autogenerated on Fri May 16 2025 03:03:33