Problemi noti e domande frequenti di Microsoft Information Protection (MIP) SDKMicrosoft Information Protection (MIP) SDK FAQs and issues

In questo articolo vengono fornite le risposte alle domande comuni e informazioni sulla risoluzione dei problemi noti e degli errori comuni.This article provides answers to Frequently Asked Questions (FAQs), and troubleshooting guidance for known issues and common errors.

Domande frequentiFrequently Asked Questions

Modifiche all'archiviazione dei metadatiMetadata Storage Changes

Recentemente è stato annunciato che è stata apportata una modifica al percorso di archiviazione dei metadati etichetta per i file di Office (Word, Excel, PowerPoint) per supportare le nuove funzionalità di Office 365, SharePoint Online e altri servizi.We recently announced that we're making a change to the label metadata storage location for Office files (Word, Excel, PowerPoint) to support new features in Office 365, SharePoint Online, and other services.

Domande frequenti sui metadatiMetadata FAQ

Domanda: quando saranno rese disponibili le prime funzionalità che richiedono la nuova posizione di archiviazione?Question: When will the first features become available that require this new storage location?

  • Si prevede che le prime funzionalità saranno disponibili nel secondo trimestre dell'anno di calendario 2021.We expect that the first features will be available in the second quarter of calendar year 2021. I clienti possono acconsentire esplicitamente alle anteprime private o pubbliche in precedenza.Customers may opt in to private or public previews earlier.

Domanda: sono interessati altri formati, ad esempio il formato PDF?Question: Are other formats impacted, such as PDF?

  • No, solo i file di Office, in particolare i file Word, Excel e PowerPoint.No, only Office files, specifically Word, Excel, and PowerPoint files.

Domanda: esiste una versione specifica di MIP SDK richiesta?Question: Is there a specific version of MIP SDK that is required?

  • MIP SDK 1,7 e versioni successive sono completamente compatibili.MIP SDK 1.7 and later are fully compatible.

Domanda: esiste una versione specifica del client di Office che sarà obbligatoria o userà questo archivio?Question: Is there a specific version of the Office client that will be required or use this store?

  • Quando vengono annunciate le funzionalità, il client di Office verrà aggiornato per sfruttare la nuova posizione di archiviazione.As features are announced, the Office client will be updated to leverage the new storage location. I nuovi percorsi di archiviazione non verranno usati finché le funzionalità non vengono abilitate dagli amministratori tenant.The new storage locations will not be used until the features are enabled by tenant administrators.

Domanda: i metadati esistenti archiviati come proprietà personalizzate in custom.xml essere mantenuti aggiornati?Question: Will the existing metadata stored as a custom property in custom.xml be kept up to date?

  • No.No. La prima volta che il documento viene salvato dopo l'abilitazione del nuovo percorso di archiviazione, i metadati dell'etichetta verranno spostati nella nuova posizione.The first time the document is saved after the new storage location is enabled, label metadata will be moved to the new location. I metadati scritti tramite LabelingOptions.ExtendedProperties rimarranno in custom.xml.Metadata written via LabelingOptions.ExtendedProperties will remain in custom.xml.

Domanda: è possibile leggere i metadati delle etichette senza l'SDK MIP?Question: Will it be possible to read the label metadata without MIP SDK?

  • Sì, ma è necessario implementare il proprio codice per analizzare il file ed estrarre le informazioni.Yes, but you'll need to implement your own code to parse the file and extract the information.

Domanda: attualmente è facile "leggere" l'etichetta estraendo le stringhe di coppie chiave/valore dal file.Question: Currently, it's easy to "read" the label by extracting the key/value pair strings from the file. La lettura sarà ancora possibile in questo modo?Will reading still be possible in this manner?

Domanda: come è possibile individuare se le nuove funzionalità sono abilitate?Question: How can I discover if the new features are enabled?

  • Queste informazioni vengono condivise in modo da raggiungere le date di rilascio delle funzionalità.We will share this information as we approach the feature release dates.

Domanda: come verrà eseguita la migrazione delle etichette?Question: How will labels be migrated?

  • La logica seguente viene usata per determinare quale sezione viene letta e usata per leggere o scrivere i dati delle etichette.The following logic is used to determine which section is read and used to read or write label data.
AzioneAction Funzionalità non abilitataFeature Not Enabled Funzionalità abilitataFeature Enabled
LetturaRead Etichetta in custom.xml (non protetto) o doc SummaryInfo (Protected).Label in custom.xml (unprotected) or Doc SummaryInfo (protected). Se nell'labelinfo.xml è presente un'etichetta, l'etichetta è valida.If label exists in labelinfo.xml, it is the effective label.
Se non è presente alcuna etichetta in labelinfo.xml, l'etichetta in custom.xml o doc SummaryInfo è l'etichetta valida.If there is no label in labelinfo.xml, label in custom.xml or Doc SummaryInfo is the effective label.
ScritturaWrite Tutte le nuove etichette vengono scritte in custom.xml (non protetto) o SummaryInfo di documenti (protetto).All new labels are written to custom.xml (unprotected) or Doc SummaryInfo (protected). Tutte le nuove etichette vengono scritte in labelinfo.xml.All new labels are written to labelinfo.xml.


Analisi dei fileFile Parsing

Domanda: è possibile scrivere nello stesso file che sto attualmente leggendo con il file SDK?Question: Can I write to the same file that I'm currently reading with the File SDK?

L'SDK MIP non supporta la lettura e la scrittura simultanee dello stesso file.The MIP SDK does not support concurrently reading and writing the same file. Tutti i file con etichetta comporteranno una copia del file di input con le azioni etichetta applicate.Any labeled files will result in a copy of the input file with the label actions applied. L'applicazione deve sostituire l'originale con il file con etichetta.Your application must replace the original with the labeled file.

Gestione delle stringhe SDKSDK string handling

Domanda: in che modo l'SDK gestisce le stringhe e il tipo di stringa da usare nel codice?Question: How does the SDK handle strings, and what string type should I be using in my code?

L'SDK è progettato per essere multipiattaforma e usa UTF-8 (Unicode Transformation Format - 8 bit) per la gestione delle stringhe.The SDK is intended to be used cross-platform, and uses UTF-8 (Unicode Transformation Format - 8-bit) for string handling. Le linee guida specifiche dipendono dalla piattaforma in uso:Specific guidance depends on the platform you're using:

PiattaformaPlatform IndicazioniGuidance
Nativa WindowsWindows native Per i client SDK C++, il tipo di libreria standard C++ std::string viene usato per passare stringhe da e verso le funzioni API.For C++ SDK clients, the C++ Standard Library type std::string is used for passing strings to/from API functions. La conversione da e verso UTF-8 viene gestita internamente da MIP SDK.Conversion to/from UTF-8 is managed internally by the MIP SDK. Quando l'API restituisce std::string, è necessario aspettarsi la codifica UTF-8 e gestire di conseguenza l'eventuale conversione della stringa.When a std::string is returned from an API, you must expect UTF-8 encoding and manage accordingly if converting the string. In alcuni casi, viene restituita una stringa come parte di un vettore uint8_t(ad esempio, una licenza di pubblicazione), ma deve essere trattata come un BLOB opaco.In some cases, a string is returned as part of a uint8_t vector (such as a publishing license (PL)), but should be treated as an opaque blob.

Per ulteriori informazioni ed esempi, vedere:For more information and examples, see:
  • Funzione WideCharToMultiByte per assistenza con la conversione di stringhe di caratteri wide a più byte, ad esempio UTF-8.WideCharToMultiByte function for assistance with converting wide character strings to multi-byte, such as UTF-8.
  • I file di esempio seguenti inclusi nel download dell'SDK:The following sample files included in the SDK download:
    • Le funzioni di utilità per le stringhe di esempio file\samples\common\string_utils.cpp, per la conversione da e verso stringhe UTF-8 wide.Sample string utility functions in file\samples\common\string_utils.cpp, for converting to/from wide UTF-8 strings.
    • Un'implementazione di wmain(int argc, wchar_t *argv[]) in file\samples\file\main.cpp, che usa le funzioni di conversione stringa precedenti.An implementation of wmain(int argc, wchar_t *argv[]) in file\samples\file\main.cpp, which uses the preceding string conversion functions.
.NET.NET Per i client .NET dell'SDK, tutte le stringhe usano la codifica predefinita UTF-16 e non è necessaria alcuna conversione speciale.For .NET SDK clients, all strings use the default UTF-16 encoding and no special conversion is needed. La conversione da e verso UTF-16 viene gestita internamente da MIP SDK.Conversion to/from UTF-16 is managed internally by the MIP SDK.
Altre piattaformeOther platforms Tutte le altre piattaforme supportate da MIP SDK includono il supporto nativo per UTF-8.All other platforms supported by the MIP SDK have native support for UTF-8.

Informazioni di riferimento per problemi ed erroriIssues and errors reference

Errore: "Formato di file non supportato"Error: "File format not supported"

Domanda: perché si verifica l'errore seguente quando si tenta di proteggere o etichettare un file PDF?Question: Why do I get the following error when attempting to protect or label a PDF file?

Formato di file non supportatoFile format not supported

Questa eccezione deriva dal tentativo di proteggere o etichettare un file PDF con firma digitale o protetto da password.This exception results from attempting to protect or label a PDF file that has been digitally signed or password protected. Per altre informazioni sulla protezione e l'assegnazione di etichette a file PDF, vedere New support for PDF encryption with Microsoft Information Protection (Nuovo supporto della crittografia PDF con Microsoft Azure Information Protection).See New support for PDF encryption with Microsoft Information Protection for more information on protecting and labeling PDF files.

Errore: "Impossibile analizzare i criteri di conformità acquisiti"Error: "Failed to parse the acquired Compliance Policy"

Domanda: perché viene riportato l'errore seguente dopo il download dell'SDK MIP e viene effettuato un tentativo di usare l'esempio di file per elencare tutte le etichette?Question: Why do I get the following error after downloading the MIP SDK and attempting to use the file sample to list all labels?

Something bad happened: Failed to parse the acquired Compliance Policy (Si è verificato un errore. Impossibile analizzare i criteri di conformità acquisiti).Something bad happened: Failed to parse the acquired Compliance Policy. Failed with: [class mip::CompliancePolicyParserException] Tag not found: policy, NodeType: 15, Name: No Name Found, Value: , Ancestors: , correlationId:[34668a40-blll-4ef8-b2af-00005aa674z9]Failed with: [class mip::CompliancePolicyParserException] Tag not found: policy, NodeType: 15, Name: No Name Found, Value: , Ancestors: , correlationId:[34668a40-blll-4ef8-b2af-00005aa674z9]

Questo errore indica che non è stata eseguita la migrazione delle etichette da Azure Information Protection all'esperienza di etichettatura unificata.This error indicates that you haven't migrated your labels from Azure Information Protection to the unified labeling experience. Vedere Come eseguire la migrazione di etichette di Azure Information Protection al Centro sicurezza e conformità di Office 365 per eseguire la migrazione delle etichette e quindi creare criteri per le etichette nel Centro sicurezza e conformità di Office 365.Follow How to migrate Azure Information Protection labels to the Office 365 Security & Compliance Center to migrate the labels, then create a Label Policy in Office 365 Security and Compliance Center.

Errore: "nopolicyexception: i criteri di etichetta non contengono dati"Error: "NoPolicyException: Label policy did not contain data"

Domanda: perché si verifica l'errore seguente quando si tenta di leggere un'etichetta o un elenco di etichette tramite il MIP SDK?Question: Why do I get the following error when trying to read a label or list labels via MIP SDK?

Nopolicyexception: i criteri di etichetta non contengono dati, CorrelationId = GUID, CorrelationId. Description = PolicyProfile, NoPolicyError. Category = SyncFile, NoPolicyError. Category = SyncFileNoPolicyException: Label policy did not contain data, CorrelationId=GUID, CorrelationId.Description=PolicyProfile, NoPolicyError.Category=SyncFile, NoPolicyError.Category=SyncFile

Questo errore indica che i criteri di etichetta non sono stati pubblicati in Microsoft Security and Compliance Center.This error indicates that a label policy has not been published in Microsoft Security and Compliance Center. Seguire creare e configurare le etichette di riservatezza e i relativi criteri per configurare i criteri di etichettatura.Follow Create and configure sensitivity labels and their policies to configure the labeling policy.

Errore: "System. ComponentModel. Win32exception: LoadLibrary failed"Error: "System.ComponentModel.Win32Exception: LoadLibrary failed"

Domanda: perché si verifica l'errore seguente quando si usa il wrapper .NET di MIP SDK?Question: Why do I get the following error when using the MIP SDK .NET Wrapper?

System. ComponentModel. Win32exception: LoadLibrary non riuscito per: [sdk_wrapper_dotnet.dll] quando viene chiamato MIP.Initialize ().System.ComponentModel.Win32Exception: LoadLibrary failed for: [sdk_wrapper_dotnet.dll] when calling MIP.Initialize().

L'applicazione non dispone del runtime necessario o non è stata compilata come versione.Your application does not have the required runtime, or was not built as Release. Per ulteriori informazioni, vedere verificare che l'applicazione disponga del runtime necessario .See Ensure your app has the required runtime for more information.

Errore: "eccezione ProxyAuthError"Error: "ProxyAuthError exception"

Domanda: perché si verifica l'errore seguente quando si usa l'SDK MIP?Question: Why do I get the following error when using the MIP SDK?

"ProxyAuthenticatonError: autenticazione proxy non supportata""ProxyAuthenticatonError: Proxy authentication is unsupported"

Il MIP SDK non supporta l'uso di proxy autenticati.The MIP SDK doesn't support the use of authenticated proxies. Per correggere questo messaggio, gli amministratori del proxy devono impostare gli endpoint di servizio di Microsoft Information Protection per ignorare il proxy.To fix this message, proxy administrators should set the Microsoft Information Protection service endpoints to bypass the proxy. Un elenco di tali endpoint è disponibile nella pagina URL e intervalli di indirizzi IP di Office 365 .A list of those endpoints is available at the Office 365 URLs and IP address ranges page. Per MIP SDK è necessario che *.protection.outlook.com (riga 9) e gli endpoint servizio Azure Information Protection (riga 73) ignorino l'autenticazione proxy.MIP SDK requires that *.protection.outlook.com (row 9) and the Azure Information Protection service endpoints (row 73) bypass proxy authentication.