I_IrmProtector.HrProtectRMS, méthode

Article
09/24/2014

Dernière modification : mercredi 7 octobre 2009

S’applique à : SharePoint Foundation 2010

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

HRESULT HrProtect(
    ILockBytes       *pilbInput,
    ILockBytes       *pilbOutput,
    I_ IrmPolicyInfoRMS    *piid,
    DWORD            *pdwStatus
) PURE;

Paramètres

pilbInput

[in] Le fichier non protégé.

pilbOutput

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

piid

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

pdwStatus

[in] É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_PROTECT_SUCCESS

Le logiciel de protection a correctement généré le flux de fichiers protégés.

MSOIPI_STATUS_ALREADY_PROTECTED

Le fichier est déjà protégé par IRM.

MSOIPI_STATUS_CANT_PROTECT

Une 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 peut pas accéder aux fonctions de SharePoint Foundation, ou ces 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 retournent des valeurs HRESULT par défaut. En règle générale, le logiciel de protection doit retourner une valeur OK positive en cas de réussite ou une valeur FAIL négative en cas d'échec.

Remarques

L'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 :

Cette méthode prend un flux de données qui représentent un fichier non protégé d'un type que le logiciel de protection IRM peut comprendre, puis génère un flux de données correspondantes qui représente une version protégée de ce fichier. Cette version protégée doit inclure la licence d'émission (IL) de document du fichier protégé et la licence utilisateur final (EUL) du serveur, ainsi que le contenu du fichier chiffré lui-même.

Le développeur du type de fichier doit décider où et comment ces composants de données sont stockés dans le fichier. Toutefois, le logiciel de protection IRM doit être en correspondance avec l'application cliente utilisée pour afficher et pour modifier des fichiers de ce type de fichier.

Le flux protégé peut également inclure un message d'avertissement qui a une compatibilité descendante avec les versions précédentes de visionneuses côté client du type de fichier du logiciel de protection.

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.