CvEnterSpan 関数CvEnterSpan Function

新しいスパンの開始を示します。Marks the beginning of a new span.

構文Syntax

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. Nll は指定できません。Cannot be NULL.

pMessage
メッセージの書式設定文字列。Message format string. Null は指定できません。Cannot be NULL.

ppSpan
結果として生成されるスパン オブジェクトを格納する変数のアドレス。Address of the variable which will hold resulting span object. アドレスには NULL を指定できません。変数には値を含めることができます。Address cannot be NULL, the variable can have any value.

戻り値Return Value

メッセージが書き込まれると S_OK を返します。S_OK when the message is successfully written. エラーが発生した場合はエラー コードを返します。Error code in case there were any errors. SUCCEEDED/FAILED マクロを使用し、エラーの状態を確認します。Use SUCCEEDED/FAILED macros to check for error condition.

要件Requirements

ヘッダー: cvmarkers.hHeader: cvmarkers.h

Unicode: CvEnterSpanW、CvEnterSpanVW、CvEnterSpanExW、CvEnterSpanExVWUnicode: CvEnterSpanW, CvEnterSpanVW, CvEnterSpanExW, CvEnterSpanExVW

ANSI: CvEnterSpanA、CvEnterSpanVA、CvEnterSpanExA、CvEnterSpanExVWANSI: CvEnterSpanA, CvEnterSpanVA, CvEnterSpanExA, CvEnterSpanExVW

関連項目See Also

C++ ライブラリ リファレンスC++ Library Reference