SecureBlackbox 2020 C++ Edition

Questions / Feedback?

TraceRequest Event

Reports a TRACE request.

Syntax

ANSI (Cross Platform)
virtual int FireTraceRequest(RESTServerTraceRequestEventParams *e);

typedef struct {
  int64 ConnectionID;
  const char *URI;
  int Handled;
  int reserved;
} RESTServerTraceRequestEventParams;

Unicode (Windows)
virtual INT FireTraceRequest(RESTServerTraceRequestEventParams *e);

typedef struct {
  LONG64 ConnectionID;
  LPCWSTR URI;
  BOOL Handled;
  INT reserved;
} RESTServerTraceRequestEventParams;
- (void)onTraceRequest:(long long)connectionID :(NSString*)URI :(int*)handled;
#define EID_RESTSERVER_TRACEREQUEST 22

virtual INT SECUREBLACKBOX_CALL FireTraceRequest(LONG64 &lConnectionID, LPSTR &lpszURI, BOOL &bHandled);

Remarks

The class fires this event to notify the application about a TRACE request received from the client.

ConnectionID indicates the connection that sent the request and URI suggests the requested resource.

Set Handled to true to indicate that your application's code will take care of the request. The application does it by providing the necessary details via SetResponseStatus, SetResponseHeader, and SetResponseFile methods. If the returned value of Handled is false, the server will try to take care of the request automatically by searching for the requested resource in DocumentRoot.

Copyright (c) 2022 /n software inc. - All rights reserved.
SecureBlackbox 2020 C++ Edition - Version 20.0 [Build 8166]