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;