I_IrmProtector.HrUnprotectRMS-Methode
Letzte Änderung: Mittwoch, 7. Oktober 2009
Gilt für: SharePoint Foundation 2010
Generiert eine ungeschützte Version der angegebenen Datei mit verwalteten Rechten.
HRESULT HrUnprotect(
ILockBytes *pilbInput,
ILockBytes *pilbOutput,
I_IrmPolicyInfoRMS *piid,
DWORD *pdwStatus
) PURE;
Parameter
pilbInput
[in] Die Datei mit verwalteten Rechten.
pilbOutput
[out] Der ungeschützte Datenstrom, der von der IRM-Schutzkomponente (Information Rights Management, Verwaltung von Informationsrechten) aus der angegebenen Datei mit verwalteten Rechten generiert wird.
piid
[in] Ein Link zu Funktionen und Daten, die den Ver-/Entschlüsselungsvorgang unterstützen.
pdwStatus
[in] Der Status des Methodenaufrufs. Mögliche Werte:
MSOIPI_STATUS_UNKNOWN
Das Ergebnis der Methode kann nicht bestimmt werden.
MSOIPI_STATUS_UNPROTECT_SUCCESS
Der ungeschützte Dateidatenstrom wurde von der Schutzkomponente erfolgreich generiert.
MSOIPI_STATUS_ALREADY_UNPROTECTED
Die angegebene Datei ist nicht geschützt.
MSOIPI_STATUS_CANT_UNPROTECT
Allgemeiner Fehler der Schutzkomponente.
MSOIPI_STATUS_NOT_MY_FILE
Bei der angegebenen Datei handelt es sich nicht um einen Dateityp, der dieser IRM-Schutzkomponente zugeordnet ist.
MSOIPI_STATUS_FILE_CORRUPT
Die angegebene Datei ist beschädigt.
MSOIPI_STATUS_WSS_IRM_FAILED
Die Schutzkomponente kann nicht auf SharePoint Foundation-Funktionen zugreifen, oder bei den Verschlüsselungsfunktionen ist ein Fehler aufgetreten.
MSOIPI_STATUS_BAD_INSTALL
Die Schutzkomponente ist nicht ordnungsgemäß installiert.
Rückgabewert
Von den Schutzkomponentenmethoden werden typische HRESULT-Werte zurückgegeben. Im Allgemeinen muss von der Schutzkomponente bei Erfolg ein positiver OK-Wert und andernfalls ein negativer FAIL-Wert zurückgegeben werden.
Hinweise
Die I_IrmProtector-Schnittstelle wird von integrierten und autonomen IRM-Schutzkomponenten implementiert. Weitere Informationen zu integrierten und autonomen Schutzkomponenten finden Sie unter Benutzerdefinierte IRM-Schutzkomponenten.
Für integrierte IRM-Schutzkomponenten:
SharePoint Foundation ruft diese Methode auf, um den Schutz von Dateien mit verwalteten Rechten der Datentypen aufzuheben, die dieser Schutzkomponente zugeordnet sind.
Diese Methode muss die Dokumentveröffentlichungslizenz und Server-Endbenutzerlizenz aus der geschützten Datei extrahieren. (Diese Zertifikate wurden in die geschützte Datei einbezogen, als diese mithilfe der I_IrmProtector.HrProtect (Methode)-Methode von der Schutzkomponente generiert wurde.) Die Schutzkomponente kann anschließend mithilfe dieser Zertifikate auf I_IrmPolicyInfo-Klasse-Methoden zugreifen, um den Schutz der Datei aufzuheben und sie zu entschlüsseln.
Für autonome IRM-Schutzkomponenten:
Autonome Schutzkomponenten müssen diese Methode nicht implementieren. Eine autonome Schutzkomponente muss E_NOTIMPL als HRESULT zurückgeben, wenn diese Methode aufgerufen wird.