StruttureStructures
mip_cc_application_infomip_cc_application_info
Uno struct che include informazioni specifiche dell'applicazioneA struct that includes application specific information
CampoField | DescrizioneDescription |
---|---|
applicationIdapplicationId | Identificatore dell'applicazione impostato nel portale di AAD, (deve essere un GUID senza parentesi quadre).Application identifier as set in the AAD portal, (Should be a GUID without brackets). |
applicationNameapplicationName | Nome dell'applicazione, (deve contenere solo caratteri ASCII validi, escluso ';')Application name, (Should only contain valid ASCII character excluding ';') |
applicationVersionapplicationVersion | Versione dell'applicazione in uso, (deve contenere solo caratteri ASCII validi, escluso ';')The version of the application being used, (Should only contain valid ASCII character excluding ';') |
typedef struct {
const char* applicationId;
const char* applicationName;
const char* applicationVersion;
} mip_cc_application_info;
mip_cc_oauth2_challengemip_cc_oauth2_challenge
Informazioni fornite da un server per generare un token OAuth2Information provided by a server to generate an OAuth2 token
CampoField | DescrizioneDescription |
---|---|
authorityauthority | Autorità OAuth2OAuth2 authority |
Risorsaresource | Risorsa OAuth2OAuth2 resource |
scopescope | Ambito OAuth2OAuth2 scope |
typedef struct {
const char* authority;
const char* resource;
const char* scope;
} mip_cc_oauth2_challenge;
mip_cc_handlemip_cc_handle
Handle opaco per l'oggetto MIPOpaque handle to MIP object
CampoField | DescrizioneDescription |
---|---|
typeIdtypeId | Numero magico che identifica in modo univoco il tipo di handle specificoMagic number uniquely identifying s specific handle type |
Datadata | Dati handle non elaboratiRaw handle data |
typedef struct {
uint32_t typeId;
void* data;
} mip_cc_handle;
mip_cc_guidmip_cc_guid
GUIDGUID
typedef struct {
char guid[37];
} mip_cc_guid;
mip_cc_kv_pairmip_cc_kv_pair
Coppia chiave/valoreKey/value pair
CampoField | DescrizioneDescription |
---|---|
Keykey | ChiaveKey |
Valorevalue | ValoreValue |
typedef struct {
const char* key;
const char* value;
} mip_cc_kv_pair;
mip_cc_errormip_cc_error
Informazioni sugli erroriError information
typedef struct {
mip_cc_result result;
char description[ERROR_STRING_BUFFER_SIZE];
// MIP_RESULT_ERROR_NETWORK details
mip_cc_network_error_category networkError_Category;
int32_t networkError_ResponseCode;
// MIP_RESULT_ERROR_NO_PERMISSIONS details
char noPermissionsError_Owner[ERROR_STRING_BUFFER_SIZE];
char noPermissionsError_Referrer[ERROR_STRING_BUFFER_SIZE];
// MIP_RESULT_ERROR_SERVICE_DISABLED details
mip_cc_service_disabled_error_extent serviceDisabledError_Extent;
} mip_cc_error;
mip_cc_http_headermip_cc_http_header
Intestazione richiesta/risposta HTTPHTTP request/response header
CampoField | DescrizioneDescription |
---|---|
namename | Nome/chiave dell'intestazioneHeader name/key |
Valorevalue | Valore intestazioneHeader value |
typedef struct {
const char* name;
const char* value;
} mip_cc_http_header;
mip_cc_http_requestmip_cc_http_request
Richiesta HTTPHTTP request
CampoField | DescrizioneDescription |
---|---|
idid | ID richiesta univoco: correlato con la stessa proprietà in mip_cc_http_responseUnique request ID--correlated with the same property in mip_cc_http_response |
tipotype | Tipo di richiesta HTTP (ad esempio, GET e POST)HTTP request type (e.g. GET vs. POST) |
urlurl | URL della richiesta HTTPHTTP request URL |
bodySizebodySize | Dimensioni del corpo della richiesta HTTP in byteSize of HTTP request body in bytes |
Corpobody | Corpo della richiesta HTTP con memorizzazione nel bufferBuffer containg HTTP request body |
headersCountheadersCount | Numero di intestazioni di richiesta HTTPNumber of HTTP request headers |
headersheaders | Buffer contenente intestazioni di richiesta HTTPBuffer containing HTTP request headers |
typedef struct {
const char* id;
mip_cc_http_request_type type;
const char* url;
int64_t bodySize;
const uint8_t* body;
int64_t headersCount;
const mip_cc_http_header* headers;
} mip_cc_http_request;
mip_cc_http_responsemip_cc_http_response
Risposta HTTPHTTP response
CampoField | DescrizioneDescription |
---|---|
idid | ID richiesta univoco: correlato con la stessa proprietà in mip_cc_http_requestUnique request ID--correlated with the same property in mip_cc_http_request |
statusCodestatusCode | Codice di stato della risposta HTTPHTTP response status code |
bodySizebodySize | Dimensione del corpo della risposta HTTP in byteSize of HTTP response body in bytes |
Corpobody | Corpo della risposta HTTP del bufferBuffer containg HTTP response body |
headersCountheadersCount | Numero di intestazioni di risposta HTTPNumber of HTTP response headers |
headersheaders | Buffer contenente intestazioni di risposta HTTPBuffer containing HTTP response headers |
typedef struct {
const char* id;
int32_t statusCode;
int64_t bodySize;
const uint8_t* body;
int64_t headersCount;
const mip_cc_http_header* headers;
} mip_cc_http_response;
mip_cc_identitymip_cc_identity
Uno struct che contiene le informazioni di identificazione dell'utenteA struct that contains user identification info
CampoField | DescrizioneDescription |
---|---|
emailemail | Indirizzo di posta elettronica utenteUser email address |
namename | Nome descrittivo dell'utente, usato per il contrassegno del contenuto.User friendly name, used for content marking. |
typedef struct {
const char* email;
const char* name;
} mip_cc_identity;
mip_cc_feature_overridemip_cc_feature_override
Definisce lo stato abilitato/disabilitato di una singola funzionalitàDefines a single feature's enabled/disabled state
CampoField | DescrizioneDescription |
---|---|
featurefeature | Nome funzionalitàFeature name |
Valorevalue | Stato abilitato/disabilitatoEnabled/disabled state |
typedef struct {
mip_cc_flighting_feature feature;
bool value;
} mip_cc_feature_override;
mip_cc_user_rightsmip_cc_user_rights
Un gruppo di utenti e i diritti associatiA group of users and the rights associated with them
CampoField | DescrizioneDescription |
---|---|
userusers | Elenco di utentiList of users |
usersCountusersCount | Numero di utentiNumber of users |
dirittirights | Elenco dei dirittiList of rights |
rightsCountrightsCount | Numero di dirittiNumber of rights |
typedef struct {
const char** users;
int64_t usersCount;
const char** rights;
int64_t rightsCount;
} mip_cc_user_rights;
mip_cc_user_rolesmip_cc_user_roles
Un gruppo di utenti e i ruoli associatiA group of users and the roles associated with them
CampoField | DescrizioneDescription |
---|---|
userusers | Elenco di utentiList of users |
usersCountusersCount | Numero di utentiNumber of users |
Ruoliroles | Elenco dei ruoliList of roles |
rolesCountrolesCount | Numero di ruoliNumber of roles |
typedef struct {
const char** users;
int64_t usersCount;
const char** roles;
int64_t rolesCount;
} mip_cc_user_roles;
mip_cc_async_taskmip_cc_async_task
Definisce una singola richiesta di invio di attività asincronaDefines a single async task dispatch request
CampoField | DescrizioneDescription |
---|---|
idid | ID attivitàTask ID |
delayMsdelayMs | Ritardo fino all'esecuzione dell'attività (in millisecondi)Delay until task execution (in milliseconds) |
executeOnIndependentThreadexecuteOnIndependentThread | Indica se l'attività deve essere eseguita in un thread completamente indipendente o se può riutilizzare un thread condivisoWhether this task should execute on a completely independent thread or can re-use a shared thread |
typedef struct {
const char* id;
int64_t delayMs;
bool executeOnIndependentThread;
} mip_cc_async_task;
mip_cc_application_action_statemip_cc_application_action_state
Rappresenta lo stato corrente dell'applicazione durante l'esecuzione di un'operazione correlata all'etichettaRepresents the current state of the application as it performs a label-related operation
CampoField | DescrizioneDescription |
---|---|
actionStateactionState | Descrive se/in che modo un'applicazione tenta di modificare lo stato dell'etichetta.Describes if/how an application is attempting to change label state. |
newLabelnewLabel | Se ' actionType ' è' UPDATE ': nuova etichetta.If 'actionType' is 'UPDATE': New label. |
newLabelExtendedPropertiesnewLabelExtendedProperties | Se ' actionType ' è' UPDATE ': proprietà aggiuntive da scrivere nei metadati.If 'actionType' is 'UPDATE': Additional properties to be written to metadata. |
newLabelAssignmentMethodnewLabelAssignmentMethod | Se ' actionType ' è' UPDATE ': il metodo di assegnazione della nuova etichetta.If 'actionType' is 'UPDATE': The method of assignment of the new label. |
isDowngradeJustifiedisDowngradeJustified | Se ' actionType ' è' UPDATE ': indica se il downgrade di un'etichetta è stato giustificato dall'utente.If 'actionType' is 'UPDATE': Whether or not a label downgrade has been justified by user. |
downgradeJustificationdowngradeJustification | Se ' actionType ' è' UPDATE ': testo per la giustificazione del downgrade dell'etichetta fornito dall'utente.If 'actionType' is 'UPDATE': Label downgrade justification text provided by user. |
supportedActionssupportedActions | Maschera di enumerazione che descrive le azioni correlate all'etichetta che un'applicazione è in grado di eseguire.Enum mask describing the label-related actions an application is able to perform. |
typedef struct {
mip_cc_label_action_state actionState;
mip_cc_label newLabel;
mip_cc_dictionary newLabelExtendedProperties;
mip_cc_label_assignment_method newLabelAssignmentMethod;
bool isDowngradeJustified;
const char* downgradeJustification;
mip_cc_label_action_type supportedActions;
} mip_cc_application_action_state;
mip_cc_document_statemip_cc_document_state
Definizione della funzione di callback per recuperare il documento metatdata, filtrato in base al nome o al prefisso.Callback function definition for retrieving document metatdata, filtered by name/prefix.
CampoField | DescrizioneDescription |
---|---|
dataStatedataState | Stato dei dati del documento come applicazione interagisce con esso.State of document data as application interacts with it. |
contentMetadataCallbackcontentMetadataCallback | Callback dei metadati del documento.Document metadata callback. |
protectionDescriptorprotectionDescriptor | Descrittore di protezione se il documento è attualmente protetto; in caso contrario, null.Protection descriptor if document is currently protected, else null. |
contentFormatcontentFormat | Formato del documento (file o posta elettronica).Format of document (file vs. email). |
auditMetadataauditMetadata | Metadati facoltativi specifici dell'applicazione usati quando si inviano report di controllo.Optional application-specific metadata that is used when sending audit reports. Valori riconosciuti:' sender ': indirizzo di posta elettronica del mittente; ' Recipients ': matrice JSON di destinatari di posta elettronica; ' LastModifiedBy ': indirizzo di posta elettronica dell'utente che ha apportato l'ultima modifica a un documento; ' LastModifiedDate ': data dell'Ultima modifica di un documentoRecognized values: 'Sender': Sender email address; 'Recipients': JSON array of email recipients; 'LastModifiedBy': Email address of the user who last modified a document; 'LastModifiedDate': Date a document was last modified |
contentMetadataVersioncontentMetadataVersion | Versione dei metadati del documento, il valore predefinito è 0.Document metadata version, default should be 0. |
contentMetadataVersionFormatcontentMetadataVersionFormat | Descrive il modo in cui viene elaborato il controllo delle versioni dei metadati.Describes how metadata versioning is processed. |
typedef struct {
const char* contentId;
mip_cc_data_state dataState;
mip_cc_metadata_callback contentMetadataCallback;
mip_cc_protection_descriptor protectionDescriptor;
mip_cc_content_format contentFormat;
mip_cc_dictionary auditMetadata;
uint32_t contentMetadataVersion;
mip_cc_metadata_version_format contentMetadataVersionFormat;
} mip_cc_document_state;
mip_cc_metadata_entrymip_cc_metadata_entry
Immissione dei metadatiMetadata entry
CampoField | DescrizioneDescription |
---|---|
Keykey | Immissione chiaveKey entry |
Valorevalue | Immissione valoreValue entry |
Versioneversion | La voce Version deve essere inizializzata su 0 se non diversamente notoVersion entry, should be initialized to 0 unless otherwise known |
typedef struct {
const char* key;
const char* value;
uint32_t version;
} mip_cc_metadata_entry;