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. NULL일 수 없습니다.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

유니코드: CvEnterSpanW, CvEnterSpanVW, CvEnterSpanExW, CvEnterSpanExVWUnicode: CvEnterSpanW, CvEnterSpanVW, CvEnterSpanExW, CvEnterSpanExVW

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

참고 항목See Also

C++ 라이브러리 참조C++ Library Reference