CvEnterSpan Function

Marks the beginning of a new span.

HRESULT CvEnterSpanW(
    _In_reads_bytes_(16) PCV_MARKERSERIES pMarkerSeries, 
    _Out_ PCV_SPAN* ppSpan, 
    _In_ PCWSTR pMessage,
    ... 
    ); 

HRESULT CvEnterSpanA(
    _In_reads_bytes_(16) PCV_MARKERSERIES pMarkerSeries, 
    _Out_ PCV_SPAN* ppSpan, 
    _In_ PCSTR pMessage, 
    ... 
    ); 

HRESULT CvEnterSpanVW(
    _In_reads_bytes_(16) PCV_MARKERSERIES pMarkerSeries, 
    _Out_ PCV_SPAN* ppSpan, 
    _In_ PCWSTR pMessage,
    _In_ va_list argList
    ); 

HRESULT CvEnterSpanVA(
    _In_reads_bytes_(16) PCV_MARKERSERIES pMarkerSeries, 
    _Out_ PCV_SPAN* ppSpan, 
    _In_ PCSTR pMessage, 
    _In_ va_list argList
    ); 

HRESULT CvEnterSpanExW(
    _In_reads_bytes_(16) PCV_MARKERSERIES pMarkerSeries, 
    _In_ CV_IMPORTANCE level, 
    _In_ int category, 
    _Out_ PCV_SPAN* ppSpan, 
    _In_ PCWSTR pMessage, 
    ... 
    ); 

HRESULT CvEnterSpanExA(
    _In_reads_bytes_(16) PCV_MARKERSERIES pMarkerSeries, 
    _In_ CV_IMPORTANCE level, 
    _In_ int category, 
    _Out_ PCV_SPAN* ppSpan, 
    _In_ PCSTR pMessage, 
    ... 
    ); 

HRESULT CvEnterSpanExVW(
    _In_reads_bytes_(16) PCV_MARKERSERIES pMarkerSeries, 
    _In_ CV_IMPORTANCE level, 
    _In_ int category, 
    _Out_ PCV_SPAN* ppSpan, 
    _In_ PCWSTR pMessage, 
    _In_ va_list argList); 

HRESULT CvEnterSpanExVA(
    _In_reads_bytes_(16) PCV_MARKERSERIES pMarkerSeries, 
    _In_ CV_IMPORTANCE level, 
    _In_ int category, 
    _Out_ PCV_SPAN* ppSpan, 
    _In_ PCSTR pMessage, 
    _In_ va_list argList); 

Parameters

• argList
  List of arguments.

• category
  Category of the span

• level
  Importance level of the span.

• pMarkerSeries
  Valid marker series context. Cannot be NULL.

• pMessage
  Message format string. Cannot be NULL.

• ppSpan
  Address of the variable which will hold resulting span object. Address cannot be NULL, the variable can have any value.

Return Value

S_OK when the message is successfully written. Error code in case there were any errors. Use SUCCEEDED/FAILED macros to check for error condition.

Requirements

Header: cvmarkers.h

Unicode: CvEnterSpanW, CvEnterSpanVW, CvEnterSpanExW, CvEnterSpanExVW

ANSI: CvEnterSpanA, CvEnterSpanVA, CvEnterSpanExA, CvEnterSpanExVW

See Also

Concepts

C++ Library Reference