I_IrmProtector.HrUnprotect, méthode

Article
09/24/2014

Dernière modification : mercredi 7 octobre 2009

S’applique à : SharePoint Foundation 2010

Génère une version non protégée du fichier spécifié géré par des droits.

HRESULT HrUnprotect(
    ILockBytes       *pilbInput,
    ILockBytes       *pilbOutput,
    I_IrmPolicyInfo    *piid,
    DWORD            *pdwStatus
) PURE;

Paramètres

pilbInput

[in] Fichier géré par des droits.

pilbOutput

[out] Flux non protégé que le logiciel de protection IRM génère à partir du fichier géré par des droits.

piid

[in] Lien vers les données relatives au fichier à protéger et les informations sur l'utilisateur à l'origine de la demande.

pdwStatus

[in] État de l'appel de méthode. Les valeurs possibles sont :

MSOIPI_STATUS_UNKNOWN

Le résultat de la méthode ne peut pas être déterminé.

MSOIPI_STATUS_UNPROTECT_SUCCESS

Le logiciel de protection a correctement généré le flux de fichier non protégé.

MSOIPI_STATUS_ALREADY_UNPROTECTED

Le fichier spécifié n'est pas protégé.

MSOIPI_STATUS_CANT_UNPROTECT

Défaillance générale du logiciel de protection.

MSOIPI_STATUS_NOT_MY_FILE

Le fichier spécifié n'est pas un type de fichier associé à ce logiciel de protection IRM.

MSOIPI_STATUS_FILE_CORRUPT

Le fichier spécifié est endommagé.

MSOIPI_STATUS_WSS_IRM_FAILED

Le logiciel de protection n'est pas en mesure d'accéder à sa plateforme de gestion des droits.

MSOIPI_STATUS_BAD_INSTALL

Le logiciel de protection n'est pas installé correctement.

Valeur renvoyée

Les méthodes du logiciel de protection renvoient des valeurs HRESULT classiques. En règle générale, le logiciel de protection doit renvoyer une valeur positive OK en cas de succès, ou une valeur négative FAIL en cas d'échec.

Remarques

L'interface I_IrmProtector, interface est implémentée par les logiciels de protection intégrés et autonomes. Pour plus d'informations sur les logiciels de protection intégrés et autonomes, voir Logiciels de protection IRM personnalisés.

Pour les logiciels de protection IRM intégrés :

Les logiciels de protection intégrés n'ont pas besoin d'implémenter cette méthode. Un logiciel de protection intégré doit renvoyer la valeur HRESULT E_NOTIMPL si cette méthode est appelée.

Pour les logiciels de protection IRM autonomes :

SharePoint Foundation appelle cette méthode pour déprotéger les fichiers gérés par des droits et dont les types sont associés à ce logiciel de protection. Pour les logiciels de protection autonomes, vous devez implémenter la méthode I_IrmProtector.HrProtect, méthode afin qu'elle configure et exécute l'ensemble du processus de gestion des droits.

En règle générale, vous devez implémenter la méthode I_IrmProtector.HrUnprotect, méthode d'un logiciel de protection autonome afin qu'elle effectue les tâches suivantes :

Utiliser le paramètre piid de la méthode I_IrmPolicyInfo.HrSetListGuid, méthode pour fournir à SharePoint Foundation le GUID de bibliothèque de documents stocké dans les métadonnées de droits du fichier. SharePoint Foundation utilise ce GUID pour que le fichier soit téléchargé vers sa bibliothèque de documents d’origine.

Utiliser l'argument pilbOutput pour fournir à SharePoint Foundation une version non chiffrée du fichier.
Renvoyer la valeur d'état appropriée dans l'argument pwdStatus.