Fonction DRMSetRevocationPoint (msdrm.h)

Article
08/24/2023

[Le Kit de développement logiciel (SDK) AD RMS tirant parti des fonctionnalités exposées par

le client dans Msdrm.dll est disponible dans Windows Server 2008, Windows Vista, Windows Server 2008 R2, Windows 7, Windows Server 2012 et Windows 8. Il peut être modifié ou

non disponible dans les versions suivantes. Utilisez plutôt active Directory Rights Management Services SDK 2.1,

qui tire parti des fonctionnalités exposées par le client dans Msipc.dll.]

La fonction DRMSetRevocationPoint définit un taux d’actualisation et un emplacement pour obtenir une liste de révocation.

Syntaxe

DRMEXPORT HRESULT UDAPICALL DRMSetRevocationPoint(
  [in] DRMPUBHANDLE hIssuanceLicense,
  [in] BOOL         fDelete,
  [in] PWSTR        wszId,
  [in] PWSTR        wszIdType,
  [in] PWSTR        wszURL,
  [in] SYSTEMTIME   *pstFrequency,
  [in] PWSTR        wszName,
  [in] PWSTR        wszPublicKey
);

Paramètres

[in] hIssuanceLicense

Handle pour une licence d’émission.

[in] fDelete

Indicateur indiquant si l’élément existant doit être supprimé : TRUE indique qu’il doit être supprimé ; FALSE indique qu’il doit être ajouté.

[in] wszId

ID de l’autorité de révocation qui publie la liste de révocation. Cela doit correspondre à l’ID donné dans le nœud ISSUER de la liste de révocation.

[in] wszIdType

Type d’ID utilisé par wszId.

[in] wszURL

URL de la liste des fichiers de révocation.

[in] pstFrequency

Fréquence à laquelle la liste doit être mise à jour.

[in] wszName

Nom facultatif lisible par l’homme pour un site de liste de révocation.

[in] wszPublicKey

Clé publique de la paire de clés utilisée pour signer et vérifier la liste de révocation.

Valeur retournée

Si la fonction réussit, la fonction retourne S_OK.

Si la fonction échoue, elle retourne une valeur HRESULT qui indique l’erreur. Les valeurs possibles incluent, sans s’y limiter, celles de la liste suivante. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.

Notes

Une liste de révocation peut révoquer des licences d’utilisateur final, des certificats de licence de serveur ou presque tout autre élément avec un GUID d’identification. Pour obtenir la liste des éléments qui peuvent être révoqués, consultez Révocation. L’URL fournie doit faire référence au fichier de liste lui-même. Le système de gestion des droits gère la vérification d’une liste de révocation valide. Cette fonction ne doit être appelée qu’une seule fois, car les appels suivants remplacent le point de révocation précédent dans la licence d’émission.

La clé publique doit être une chaîne encodée en base 64.

Notez que si aucun point de révocation n’est défini dans la licence, la licence peut toujours être révoquée par une liste de révocation signée par l’émetteur de la licence.