DRMGetUsers-Funktion (msdrm.h)

  • Artikel

[Das AD RMS SDK nutzt Funktionen, die von verfügbar gemacht werden

der Client in Msdrm.dll ist für die Verwendung in Windows Server 2008, Windows Vista, Windows Server 2008 R2, Windows 7, Windows Server 2012 und Windows 8 verfügbar. Es kann geändert werden oder

in nachfolgenden Versionen nicht verfügbar. Verwenden Sie stattdessen active Directory Rights Management Services SDK 2.1.

die funktionalität nutzt, die vom Client in Msipc.dll verfügbar gemacht wird.]

Die DRMGetUsers-Funktion ruft einen bestimmten Benutzer aus einer Ausstellungslizenz ab.

Syntax

DRMEXPORT HRESULT UDAPICALL DRMGetUsers(
  [in]  DRMPUBHANDLE hIssuanceLicense,
  [in]  UINT         uIndex,
  [out] DRMPUBHANDLE *phUser
);

Parameter

[in] hIssuanceLicense

Das Handle der Ausstellungslizenz, aus der der Benutzer abgerufen werden soll.

[in] uIndex

Der nullbasierte Index des Benutzers in der abzurufenden Ausstellungslizenz. Um alle Benutzer in der Ausstellungslizenz aufzulisten, erstellen Sie eine Schleife, die bei Null beginnt und um eins erhöht wird. Wenn die Funktion E_DRM_NO_MORE_DATA zurückgibt, sind keine Weiteren Benutzer in der Ausstellungslizenz vorhanden.

[out] phUser

Ein Zeiger auf einen DRMPUBHANDLE-Wert , der das Handle an den angeforderten Benutzer empfängt. Rufen Sie DRMClosePubHandle auf, um das Handle zu schließen.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion S_OK zurück.

Wenn die Funktion fehlschlägt, wird ein HRESULT-Wert zurückgegeben, der den Fehler angibt. Mögliche Werte sind u. a. die werte in der folgenden Liste. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.

Hinweise

Um alle Benutzer in der Ausstellungslizenz aufzulisten, erstellen Sie eine Schleife, die bei Null beginnt und um eins erhöht wird. Wenn die Funktion E_DRM_NO_MORE_DATA zurückgibt, sind keine Weiteren Benutzer in der Ausstellungslizenz vorhanden. Rufen Sie DRMClosePubHandle auf, um das Benutzerhandle zu schließen, das durch Aufrufen dieser Funktion erstellt wurde.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile msdrm.h
Bibliothek Msdrm.lib
DLL Msdrm.dll

Weitere Informationen

AD RMS-Funktionen

DRMGetUserInfo

DRMGetUserRights