Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
[Das AD RMS SDK, das die von verfügbar gemachten Funktionen nutzt
Der Client in Msdrm.dll steht für die Verwendung in Windows Server 2008, Windows Vista, Windows Server 2008 R2, Windows 7, Windows Server 2012 und Windows 8 zur Verfügung. Sie kann geändert werden oder
in nachfolgenden Versionen nicht verfügbar. Verwenden Sie stattdessen das Active Directory Rights Management Services SDK 2.1.
die vom Client in Msipc.dll verfügbar gemachte Funktionalität nutzt.]
Die DRMGetRevocationPoint-Funktion ruft Informationen über den Sperrpunkt für eine Ausstellungslizenz ab.
Syntax
DRMEXPORT HRESULT UDAPICALL DRMGetRevocationPoint(
[in] DRMPUBHANDLE hIssuanceLicense,
[in, out] UINT *puIdLength,
[out] PWSTR wszId,
[in, out] UINT *puIdTypeLength,
[out] PWSTR wszIdType,
[in, out] UINT *puURLLength,
[out] PWSTR wszRL,
[out] SYSTEMTIME *pstFrequency,
[in, out] UINT *puNameLength,
[out] PWSTR wszName,
[in, out] UINT *puPublicKeyLength,
[out] PWSTR wszPublicKey
);
Parameter
[in] hIssuanceLicense
Ein Handle für die Ausstellungslizenz zum Abrufen der Informationen.
[in, out] puIdLength
Ein Zeiger auf einen UINT-Wert , der bei einem Eintrag die Länge des wszId-Puffers in Zeichen enthält. Diese Länge muss das beendende NULL-Zeichen enthalten.
Nachdem die Funktion zurückgegeben wurde, enthält dieser Wert die Anzahl der Zeichen, einschließlich des beendenden NULL-Zeichens, die in den wszId-Puffer kopiert wurden.
[out] wszId
Ein Zeiger auf eine Unicode-Zeichenfolge mit Null-Endung, die die GUID empfängt, die den Sperrpunkt identifiziert. Die Größe dieses Puffers wird durch den puIdLength-Parameter angegeben.
Um die erforderliche Größe dieses Puffers zu bestimmen, übergeben Sie NULL für diesen Parameter. Die Funktion platziert die Größe in Zeichen, einschließlich des beendenden NULL-Zeichens, im wert puIdLength .
[in, out] puIdTypeLength
Ein Zeiger auf einen UINT-Wert , der bei einem Eintrag die Länge des wszIdType-Puffers in Zeichen enthält. Diese Länge muss das beendende NULL-Zeichen enthalten.
Nachdem die Funktion zurückgegeben wurde, enthält dieser Wert die Anzahl der Zeichen, einschließlich des beendenden NULL-Zeichens, die in den wszIdType-Puffer kopiert wurden.
[out] wszIdType
Ein Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die den Typ des Sperrpunktbezeichners empfängt. Die Größe dieses Puffers wird durch den puIdTypeLength-Parameter angegeben.
Um die erforderliche Größe dieses Puffers zu bestimmen, übergeben Sie NULL für diesen Parameter. Die Funktion platziert die Größe in Zeichen, einschließlich des beendenden NULL-Zeichens, im wert puIdTypeLength .
[in, out] puURLLength
Ein Zeiger auf einen UINT-Wert , der bei einem Eintrag die Länge des wszURL-Puffers in Zeichen enthält. Diese Länge muss das beendende NULL-Zeichen enthalten.
Nachdem die Funktion zurückgegeben wurde, enthält dieser Wert die Anzahl der Zeichen, einschließlich des beendenden NULL-Zeichens, die in den wszURL-Puffer kopiert wurden.
[out] wszRL
Ein Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die die URL empfängt, in der eine Sperrliste abgerufen werden kann. Die Größe dieses Puffers wird durch den puURLLength-Parameter angegeben.
Um die erforderliche Größe dieses Puffers zu bestimmen, übergeben Sie NULL für diesen Parameter. Die Funktion platziert die Größe in Zeichen, einschließlich des beendenden NULL-Zeichens, im wert puURLLength .
[out] pstFrequency
Ein Zeiger auf eine SYSTEMTIME-Struktur , die die Häufigkeit empfängt, mit der die Sperrliste aktualisiert werden muss. Dieser Parameter ist erforderlich und darf nicht NULL sein.
[in, out] puNameLength
Ein Zeiger auf einen UINT-Wert , der bei einem Eintrag die Länge des wszName-Puffers in Zeichen enthält. Diese Länge muss das beendende NULL-Zeichen enthalten.
Nachdem die Funktion zurückgegeben wurde, enthält dieser Wert die Anzahl der Zeichen, einschließlich des beendenden NULL-Zeichens, die in den wszName-Puffer kopiert wurden.
[out] wszName
Ein Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die den lesbaren Namen für den Sperrspeicherort empfängt. Die Größe dieses Puffers wird durch den puNameLength-Parameter angegeben.
Um die erforderliche Größe dieses Puffers zu bestimmen, übergeben Sie NULL für diesen Parameter. Die Funktion platziert die Größe in Zeichen, einschließlich des beendenden NULL-Zeichens, im wert puNameLength .
[in, out] puPublicKeyLength
Ein Zeiger auf einen UINT-Wert , der bei einem Eintrag die Länge des wszPublicKey-Puffers in Zeichen enthält. Diese Länge muss das beendende NULL-Zeichen enthalten.
Nachdem die Funktion zurückgegeben wurde, enthält dieser Wert die Anzahl der Zeichen, einschließlich des beendenden NULL-Zeichens, die in den Puffer wszPublicKey kopiert wurden.
[out] wszPublicKey
Ein Zeiger auf eine Unicode-Zeichenfolge mit Null-Beendigung, die den optionalen öffentlichen Schlüssel empfängt, um eine Sperrliste außerhalb der Vertrauenskette des Inhalts zu identifizieren. Die Größe dieses Puffers wird durch den puPublicKeyLength-Parameter angegeben.
Um die erforderliche Größe dieses Puffers zu bestimmen, übergeben Sie NULL für diesen Parameter. Die Funktion platziert die Größe in Zeichen, einschließlich des beendenden NULL-Zeichens, im wert puPublicKeyLength .
Rückgabewert
Wenn die Funktion erfolgreich ist, gibt die Funktion S_OK zurück.
Wenn die Funktion fehlschlägt, gibt sie einen HRESULT-Wert zurück, der den Fehler angibt. Mögliche Werte sind unter anderem die Werte in der folgenden Liste. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.
Hinweise
Eine Sperrliste kann Endbenutzerlizenzen, Serverlizenzgeberzertifikate oder fast alles andere, das über eine identifizierende GUID verfügt, widerrufen. Die angegebene URL sollte auf die Listendatei selbst verweisen. Active Directory Rights Management Services (AD RMS) übernimmt die Überprüfung auf eine gültige Sperrliste. Sie können diese Funktion für jede Sperrpunktstruktur in einer Lizenz aufrufen, wenn DRMCreateBoundLicense aufgrund einer veralteten oder fehlenden Sperrliste fehlschlägt. Eine einfachere Methode besteht jedoch darin, DRMAcquireAdvisories aufzurufen, wodurch alle Sperrlisten für Sie aktualisiert werden.
Wenn ein öffentlicher Schlüssel bereitgestellt wird, sollte es sich um einen wohlgeformten öffentlichen XrML-Schlüsselknoten handeln. Wenn die Sperrliste mit einem Schlüsselpaar außerhalb der Vertrauenskette des Inhalts signiert ist, muss hier der öffentliche Schlüssel dieses Schlüsselpaars angegeben werden. Andernfalls sollte sie nicht verwendet werden.
Requirements (Anforderungen)
| Zielplattform | Windows |
| Kopfzeile | msdrm.h |
| Bibliothek | Msdrm.lib |
| DLL | Msdrm.dll |