CvEnterSpan 函数

对新范围的开始进行标记。

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); 

参数

• argList
  参数列表。

• category
  区域的类别。

• level
  范围的重要性等级。

• pMarkerSeries
  有效标记系列上下文。不能为 NULL。

• pMessage
  消息格式字符串。不能为 NULL。

• ppSpan
  会保存发生的大小对象变量的地址。地址不能为 null，此变量可以具有任何值。

返回值

S_OK，当消息成功写入。错误代码，当有任何错误时。使用 SUCCEEDED/FAILED 宏检查错误状态。

要求

**页眉：**cvmarkers.h

Unicode: CvEnterSpanW，CvEnterSpanVW，CvEnterSpanExW，CvEnterSpanExVW

ANSI: CvEnterSpanA，CvEnterSpanVA，CvEnterSpanExA，CvEnterSpanExVW

请参见

概念

C++ 库参考