I_IrmProtector.HrUnprotectRMS, 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 géré par des droits.

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

Paramètres

pilbInput

[in] Le fichier géré par des droits.

pilbOutput

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

piid

[in] Un lien vers des fonctions et données qui aident au processus de chiffrement/déchiffrement.

pdwStatus

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

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 fichiers 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 d'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 ne parvient pas à accéder aux fonctions SharePoint Foundation, ou les fonctions de chiffrement ont échoué.

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 par défaut. En général, le logiciel de protection renvoie une valeur OK positive en cas de succès ou une valeur FAIL négative en cas d'échec.

Remarques

I_IrmProtector, interface est implémentée par les logiciels de protection IRM 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 :

SharePoint Foundation appelle cette méthode pour ôter la protection des fichiers gérés par des droits des types de fichiers associés à ce logiciel de protection.

Cette méthode doit extraire la licence d'émission et la Licence Utilisateur final du fichier protégé. (Ces certificats ont été inclus dans le fichier protégé lors de sa création par la méthode I_IrmProtector.HrProtect, méthode du logiciel de protection.) Le logiciel de protection peut ensuite utiliser ces certificats pour accéder aux méthodes I_IrmPolicyInfo, classe afin d'ôter la protection du fichier et de le déchiffrer.

Pour les logiciels de protection IRM autonomes :

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