I_IrmProtector.HrUnprotect-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_IrmPolicyInfo *piid,
DWORD *pdwStatus
) PURE;
Parameter
pilbInput
[in] Die Datei mit verwalteten Rechten.
pilbOutput
[out] Der ungeschützte Stream, der vom IRM-Schutz (Information Rights Management, Verwaltung von Informationsrechten) aus der Datei mit verwalteten Rechten generiert wird.
piid
[in] Ein Link zu Daten der zu schützenden Datei und zu dem Benutzer, der sie anfordert.
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 Dateistream wurde vom Schutz erfolgreich generiert.
MSOIPI_STATUS_ALREADY_UNPROTECTED
Die angegebene Datei ist nicht geschützt.
MSOIPI_STATUS_CANT_UNPROTECT
Allgemeiner Fehler des Schutzes.
MSOIPI_STATUS_NOT_MY_FILE
Bei der angegebenen Datei handelt es sich nicht um einen Dateityp, der diesem IRM-Schutz zugeordnet ist.
MSOIPI_STATUS_FILE_CORRUPT
Die angegebene Datei ist beschädigt.
MSOIPI_STATUS_WSS_IRM_FAILED
Der Schutz kann nicht auf seine Rechteverwaltungsplattform zugreifen.
MSOIPI_STATUS_BAD_INSTALL
Der Schutz ist nicht ordnungsgemäß installiert.
Rückgabewert
Von den Schutzmethoden werden typische HRESULT-Werte zurückgegeben. Im Allgemeinen sollte bei Erfolg ein positiver OK-Wert vom Schutz zurückgegeben werden bzw. ein negativer FAIL-Wert, wenn die Aktion nicht erfolgreich war.
Hinweise
Die I_IrmProtector-Schnittstelle wird durch integrierte und autonome IRM-Schutzkomponenten implementiert. Weitere Informationen zu integrierten und autonomen Schutzkomponenten finden Sie unter Benutzerdefinierte IRM-Schutzkomponenten.
Für den integrierten IRM-Schutz:
Diese Methode muss vom integrierten Schutz nicht implementiert werden. Ein integrierter Schutz sollte den HRESULT-Wert E_NOTIMPL zurückgeben, falls diese Methode aufgerufen wird.
Für den autonomen IRM-Schutz:
Diese Methode wird von SharePoint Foundation aufgerufen, um den Schutz von der Rechteverwaltung unterliegenden Dateien der diesem Schutz zugeordneten Dateitypen aufzuheben. Für autonome Schutzkomponenten müssen Sie die I_IrmProtector.HrProtect (Methode)-Methode so implementieren, dass der gesamte Rechteverwaltungsprozess von der Methode konfiguriert und ausgeführt wird.
Im Allgemeinen sollten Sie die I_IrmProtector.HrUnprotect-Methode-Methode eines autonomen Schutzes implementieren, sodass die folgenden Aufgaben erfüllt werden:
Verwenden Sie den piid-Parameter der I_IrmPolicyInfo.HrSetListGuid (Methode)-Methode, um für SharePoint Foundation die Dokumentbibliothek-GUID bereitzustellen, die in den Rechtemetadaten der Datei gespeichert ist. Diese GUID wird von SharePoint Foundation verwendet, um sicherzustellen, dass die Datei in die Dokumentbibliothek hochgeladen wird, aus der sie heruntergeladen wurde.
Verwenden Sie das pilbOutput-Argument, um eine unverschlüsselte Version der Datei für SharePoint Foundation bereitzustellen.
Geben Sie den entsprechenden Statuswert im pwdStatus-Argument zurück.