CvEnterSpan, fonctionCvEnterSpan function

Marque le début d’un nouvel intervalle.Marks the beginning of a new span.

SyntaxeSyntax

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

ParamètresParameters

argList
Liste d’arguments.List of arguments.

category
Catégorie de l’intervalleCategory of the span

level
Niveau d’importance de l’intervalle.Importance level of the span.

pMarkerSeries
Contexte valide de la série de marqueurs.Valid marker series context. Ne peut pas être Null.Cannot be NULL.

pMessage
Chaîne de format de message.Message-format string. Ne peut pas être Null.Cannot be NULL.

ppSpan
Adresse de la variable qui doit contenir l’objet d’intervalle résultant.Address of the variable that will hold resulting span object. L’adresse ne peut pas être Null et la variable peut avoir n’importe quelle valeur.Address cannot be NULL, the variable can have any value.

Valeur de retourReturn Value

S_OK lorsque le message est correctement écrit.S_OK when the message is successfully written. Code d’erreur en cas d’erreur.Error code in case there were any errors. Utilisez les macros SUCCEEDED/FAILED pour vérifier la condition d’erreur.Use SUCCEEDED/FAILED macros to check for error condition.

Configuration requiseRequirements

En-tête : cvmarkers.hHeader: cvmarkers.h

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

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

Voir aussiSee also

Informations de référence sur la bibliothèque C++C++ library reference