Microsoft Information Protection SDK - C 1.17
API Reference Documentation for C
Loading...
Searching...
No Matches
label_cc.h File Reference

Contains C API definitions for label. More...

Go to the source code of this file.

Typedefs

typedef mip_cc_handlemip_cc_label
 

Functions

 MIP_CC_API (void) MIP_CC_ReleaseLabel(mip_cc_label label)
 Release resources associated with a label.
 
 MIP_CC_API (mip_cc_result) MIP_CC_Label_GetId(const mip_cc_label label
 Gets label ID.
 

Variables

mip_cc_guidlabelId
 
mip_cc_guid mip_cc_errorerrorInfo
 
int64_t * nameSize
 
char * nameBuffer
 
char const int64_t nameBufferSize
 
char const int64_t int64_t * actualNameSize
 
int64_t * descriptionSize
 
char * descriptionBuffer
 
char const int64_t descriptionBufferSize
 
char const int64_t int64_t * actualDescriptionSize
 
int64_t * colorSize
 
char * colorBuffer
 
char const int64_t colorBufferSize
 
char const int64_t int64_t * actualColorSize
 
int32_t * sensitivity
 
int64_t * tooltipSize
 
char * tooltipBuffer
 
char const int64_t tooltipBufferSize
 
char const int64_t int64_t * actualTooltipSize
 
bool * isActive
 
mip_cc_labelparent
 
int64_t * childrenSize
 
mip_cc_labelchildrenBuffer
 
mip_cc_label const int64_t childrenBufferSize
 
mip_cc_label const int64_t int64_t * actualChildrenSize
 
mip_cc_dictionarysettings
 

Detailed Description

Contains C API definitions for label.

Typedef Documentation

◆ mip_cc_label

Function Documentation

◆ MIP_CC_API() [1/2]

MIP_CC_API ( mip_cc_result ) const

Gets label ID.

Gets policy-defined custom settings of a label.

Gets the children labels.

Gets the number of children labels.

Gets the parent label, if any.

Gets whether or not a label is active.

Gets label auto-classification tooltip.

Gets size of buffer required to store auto-classification tooltip.

Gets label tooltip.

Gets size of buffer required to store tooltip.

Gets sensitivity level of label. Higher value means more sensitive.

Gets label color.

Gets size of buffer required to store color.

Gets label description.

Gets size of buffer required to store description.

Gets label name.

Gets size of buffer required to store name.

Parameters
labelLabel
labelId[Output] Label ID
errorInfo[Output] (Optional) Failure info if operation result is error
Returns
Result code indicating success or failure
Parameters
labelLabel
nameSize[Output] Size of buffer to hold name (in number of chars)
errorInfo[Output] (Optional) Failure info if operation result is error
Returns
Result code indicating success or failure
Parameters
labelLabel
nameBuffer[Output] Buffer the name will be copied into.
nameBufferSizeSize (in number of chars) of the nameBuffer.
actualNameSize[Output] Number of chars written to the buffer
errorInfo[Output] (Optional) Failure info if operation result is error
Returns
Result code indicating success or failure
Note
If nameBuffer is null or insufficient, MIP_RESULT_ERROR_INSUFFICIENT_BUFFER will be returned and actualNameSize will be set to the minimum required buffer size.
Parameters
labelLabel
descriptionSize[Output] Size of buffer to hold description (in number of chars)
errorInfo[Output] (Optional) Failure info if operation result is error
Returns
Result code indicating success or failure
Parameters
labelLabel
descriptionBuffer[Output] Buffer the description will be copied into.
descriptionBufferSizeSize (in number of chars) of the descriptionBuffer.
actualDescriptionSize[Output] Number of chars written to the buffer
errorInfo[Output] (Optional) Failure info if operation result is error
Returns
Result code indicating success or failure
Note
If descriptionBuffer is null or insufficient, MIP_RESULT_ERROR_INSUFFICIENT_BUFFER will be returned and actualDescriptionSize will be set to the minimum required buffer size.
Parameters
labelLabel
colorSize[Output] Size of buffer to hold color (in number of chars)
errorInfo[Output] (Optional) Failure info if operation result is error
Returns
Result code indicating success or failure
Parameters
labelLabel
colorBuffer[Output] Buffer the color will be copied into (in #RRGGBB format).
colorBufferSizeSize (in number of chars) of the colorBuffer.
actualColorSize[Output] Number of chars written to the buffer
errorInfo[Output] (Optional) Failure info if operation result is error
Returns
Result code indicating success or failure
Note
If colorBuffer is null or insufficient, MIP_RESULT_ERROR_INSUFFICIENT_BUFFER will be returned and actualColorSize will be set to the minimum required buffer size.
Parameters
labelLabel
sensitivity[Output] Sensitivity level
errorInfo[Output] (Optional) Failure info if operation result is error
Returns
Result code indicating success or failure
Parameters
labelLabel
tooltipSize[Output] Size of buffer to hold tooltip (in number of chars)
errorInfo[Output] (Optional) Failure info if operation result is error
Returns
Result code indicating success or failure
Parameters
labelLabel
tooltipBuffer[Output] Buffer the tooltip will be copied into.
tooltipBufferSizeSize (in number of chars) of the tooltipBuffer.
actualTooltipSize[Output] Number of chars written to the buffer
errorInfo[Output] (Optional) Failure info if operation result is error
Returns
Result code indicating success or failure
Note
If tooltipBuffer is null or insufficient, MIP_RESULT_ERROR_INSUFFICIENT_BUFFER will be returned and actualTooltipSize will be set to the minimum required buffer size.
Parameters
labelLabel
isActive[Output] Whether or not a label is considered active.
errorInfo[Output] (Optional) Failure info if operation result is error
Returns
Result code indicating success or failure
Note
Only active labels can be applied. Inactivte labels cannot be applied and are used for display purposes only.
Parameters
labelLabel
parent[Output] Parent label, if any, else null
errorInfo[Output] (Optional) Failure info if operation result is error
Returns
Result code indicating success or failure
Parameters
labelLabel
childrenSize[Output] Number of children
errorInfo[Output] (Optional) Failure info if operation result is error
Returns
Result code indicating success or failure
Parameters
labelLabel
childrenBuffer[Output] Buffer the children labels will be copied into. Children labels are owned by the caller and must be released with MIP_CC_ReleaseLabel.
childrenBufferSizeSize (in number of labels) of the childrenBuffer.
actualChildrenSize[Output] Number of children labels written to the buffer
errorInfo[Output] (Optional) Failure info if operation result is error
Returns
Result code indicating success or failure
Note
If childrenBuffer is null or insufficient, MIP_RESULT_ERROR_INSUFFICIENT_BUFFER will be returned and actualChildrenSize will be set to the minimum required buffer size
Parameters
labelLabel
settings[Output] Dictionary of settings, owned by the caller
errorInfo[Output] (Optional) Failure info if operation result is error
Returns
Result code indicating success or failure
Note
The 'settings' variable must be released by the caller by calling MIP_CC_ReleaseDictionary

◆ MIP_CC_API() [2/2]

MIP_CC_API ( void )

Release resources associated with a label.

Parameters
labelLabel to be released

Variable Documentation

◆ actualChildrenSize

mip_cc_label const int64_t int64_t* actualChildrenSize

◆ actualColorSize

char const int64_t int64_t* actualColorSize

◆ actualDescriptionSize

char const int64_t int64_t* actualDescriptionSize

◆ actualNameSize

char const int64_t int64_t* actualNameSize

◆ actualTooltipSize

char const int64_t int64_t * actualTooltipSize

◆ childrenBuffer

mip_cc_label* childrenBuffer

◆ childrenBufferSize

mip_cc_label const int64_t childrenBufferSize

◆ childrenSize

int64_t* childrenSize

◆ colorBuffer

char* colorBuffer

◆ colorBufferSize

char const int64_t colorBufferSize

◆ colorSize

int64_t* colorSize

◆ descriptionBuffer

char* descriptionBuffer

◆ descriptionBufferSize

char const int64_t descriptionBufferSize

◆ descriptionSize

int64_t* descriptionSize

◆ errorInfo

◆ isActive

bool* isActive

◆ labelId

mip_cc_guid* labelId

◆ nameBuffer

char* nameBuffer

◆ nameBufferSize

char const int64_t nameBufferSize

◆ nameSize

int64_t* nameSize

◆ parent

mip_cc_label* parent

◆ sensitivity

int32_t* sensitivity

◆ settings

mip_cc_dictionary* settings

◆ tooltipBuffer

char * tooltipBuffer

◆ tooltipBufferSize

char const int64_t tooltipBufferSize

◆ tooltipSize

int64_t * tooltipSize