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 DRMActivate-Funktion ruft ein Lockbox- und Computerzertifikat für einen Computer oder ein Berechtigungskontozertifikat für einen Benutzer ab.
Syntax
DRMEXPORT HRESULT UDAPICALL DRMActivate(
[in] DRMHSESSION hClient,
[in] UINT uFlags,
[in] UINT uLangID,
[in] DRM_ACTSERV_INFO *pActServInfo,
[in] VOID *pvContext,
[in] HWND hParentWnd
);
Parameter
[in] hClient
Ein Von DRMCreateClientSession erstelltes Handle für eine Clientsitzung.
[in] uFlags
Gibt den gewünschten Aktivierungstyp sowie zusätzliche Optionen an. Weitere Informationen finden Sie unter Hinweise. Dieser Parameter kann eine Kombination aus mindestens einem der folgenden Flags sein.
DRM_ACTIVATE_MACHINE
Aktivieren Sie den Computer. Das DRM_ACTIVATE_SILENT-Flag ist ebenfalls erforderlich, aber das DRM_ACTIVATE_GROUPIDENTITY-Flag darf nicht festgelegt werden. Der pActServInfo-Parameter wird ignoriert.
Jeder Computer wird auf Benutzerbasis aktiviert. Das heißt, das Computerzertifikat wird generiert und für den aktuell angemeldeten Benutzer gespeichert.
Die in der FUNKTION DRMCreateClientSession angegebene Funktion des Anwendungsrückrufs wird mit der DRM_MSG_ACTIVATE_MACHINE-Nachricht aufgerufen, um die Computeraktivierung status Feedback bereitzustellen.
DRM_ACTIVATE_GROUPIDENTITY
Aktiviert ein Rechtekonto. Dieses Flag kann nicht mit DRM_ACTIVATE_MACHINE kombiniert werden.
Das DRM_ACTIVATE_SILENT-Flag ist für RMS v1.0 SP2 und Windows Vista erforderlich. Das DRM_ACTIVATE_SILENT-Flag ist jedoch optional für Windows Vista mit SP1 und Windows Server 2008.
Die in der Funktion DRMCreateClientSession angegebene Funktion des Anwendungsrückrufs wird mit der DRM_MSG_ACTIVATE_GROUPIDENTITY-Nachricht aufgerufen, um die Aktivierung des Rechtekontos status Feedback bereitzustellen.
DRM_ACTIVATE_TEMPORARY
Erwerben Eines Zertifikats für temporäre Rechtekonto (RAC). Ein temporärer RAC ist nur für einen kurzen Zeitraum gut, wird aber im permanenten Lizenzspeicher gespeichert. Dieses Flag wird bei nichtsilenter Aktivierung ignoriert. Weitere Informationen finden Sie unter Hinweise.
DRM_ACTIVATE_CANCEL
Abbrechen eines laufenden Aktivierungsversuchs.
DRM_ACTIVATE_SILENT
Aktivieren Sie einen Benutzer, ohne ein Windows-Kennwortdialogfeld anzuzeigen. Dieses Flag ist für DRM_ACTIVATE_MACHINE erforderlich und je nach Betriebssystem für DRM_ACTIVATE_GROUPIDENTITY optional. Weitere Informationen finden Sie im Parameter DRM_ACTIVATE_GROUPIDENTITY .
Wenn dieses Flag mit DRM_ACTIVATE_GROUPIDENTITY verwendet wird, kann der pActServInfo-Parameter nicht NULL sein. Wenn es mit DRM_ACTIVATE_MACHINE verwendet wird, wird pActServInfo ignoriert.
DRM_ACTIVATE_SHARED_GROUPIDENTITY
Dieses Flag wird nicht verwendet.
DRM_ACTIVATE_DELAYED
Verzögerte Computeraktivierung. Bei der normalen automatischen Aktivierung erhält der Client eine CAB-Datei, die Aktivierungsdateien enthält, die erweitert und automatisch ausgeführt werden. Mit diesem Flag werden die Dateien an einem Speicherort gespeichert, der an den pvParam-Parameter der Rückruffunktion übergeben wird, wo ein Client sie vor dem Erweitern und Ausführen auf Viren überprüfen kann.
[in] uLangID
Die von der Anwendung verwendete Sprach-ID. Wenn dieser Parameter auf Null festgelegt ist, wird die Standardsprach-ID für den angemeldeten Benutzer verwendet.
[in] pActServInfo
Optionale Serverinformationen. Wenn der Client nicht für die Verwendung Active Directory-Verbunddienste (AD FS) (ADFS) mit AD RMS konfiguriert wurde, können Sie NULL übergeben, um den Windows Live ID-Dienst für die Dienstermittlung zu verwenden. Wenn der Client für die Verwendung von AD FS konfiguriert wurde, müssen Sie die Windows Live-Zertifizierungs-URL übergeben. Weitere Informationen zur Dienstermittlung finden Sie unter DRMGetServiceLocation.
[in] pvContext
Ein anwendungsdefinierter 32-Bit-Wert, der im pvContext-Parameter der Rückruffunktion gesendet wird. Dieser Wert kann ein Zeiger auf Daten, ein Zeiger auf ein Ereignishandle oder was auch immer die benutzerdefinierte Rückruffunktion behandeln soll. Weitere Informationen finden Sie unter Rückrufprototyp.
[in] hParentWnd
Übergeordnetes Fensterhandle, das bei der nichtsilenten Windows Live ID-Aktivierung verwendet wird (nur Benutzeraktivierung). Bei nichtsilenter Aktivierung wird ein Windows Live ID-Fenster geöffnet, um Benutzerinformationen anzufordern. Mit diesem Parameter kann die Anwendung ein beliebiges Fenster als übergeordnetes Fenster zuweisen. Wenn dieser Parameter NULL ist, wird das aktive Fenster verwendet.
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
Wenn eine Anwendung versucht, einen Benutzer auf einem Computer zu aktivieren, der noch nicht aktiviert wurde, schlägt die Funktion fehl. Es wird empfohlen, dass eine Anwendung DRMIsActivated aufruft, bevor sie diese Funktion aufruft, um die Aktivierung status des Computers zu bestimmen. Wenn Sie einen bereits aktivierten Computer aktivieren, werden das vorhandene Lockbox- und Computerzertifikat überschrieben. Durch die zweite Aktivierung eines Benutzers wird dem Computer ein zusätzliches Berechtigungskontozertifikat hinzugefügt. Ein Benutzer muss einen bestimmten Computer nur einmal aktivieren, obwohl Updates in der Lockbox-Architektur möglicherweise das Herunterladen und Aktivieren einer neuen Lockbox erfordern.
Es gibt mehrere Optionen für die Aktivierung.
| Option | BESCHREIBUNG |
|---|---|
| Still oder unsilent | Die nichtsilent-Aktivierung ist die Standardeinstellung. Die automatische Aktivierung wird von DRM_ACTIVATE_SILENT angegeben und ist für die Computeraktivierung erforderlich. Wenn die unbeaufsichtigte Aktivierung angegeben ist und pActServInfo nicht NULL ist, erstellt und sendet die Funktion eine Aktivierungsanforderung an die URL, die im wszURL-Member von pActServInfo angegeben ist. Weitere Informationen finden Sie unter DRM_ACTSERV_INFO. |
| Windows oder Windows Live ID | Dies wird durch den Typ des An hClient übergebenen Clienthandles bestimmt. |
| Temporär oder permanent | Dies gilt nur für ein Rights Account Certificate (RAC), nicht für ein Computerzertifikat. Die permanente Aktivierung ist die Standardeinstellung. Temporär wird durch das flag DRM_ACTIVATE_TEMPORARY angegeben. Wenn Sie eine temporäre RAC mithilfe des flags DRM_ACTIVATE_TEMPORARY erwerben, wird der RAC im permanenten Lizenzspeicher gespeichert, läuft jedoch in Kürze ab. Die Standardgültigkeitsdauer für einen temporären RAC beträgt 15 Minuten. Dies kann jedoch vom Administrator des AD RMS-Diensts geändert werden. Um zu vermeiden, dass der Lizenzspeicher mit abgelaufenen RACs überladen wird, sollten Sie beim Beenden einer Clientsitzung einen temporären RAC löschen. |
In der folgenden Liste wird beschrieben, was mit Kombinationen dieser Optionen geschieht.
| Option | Temporäre Prozeduren | Dauerhaft |
|---|---|---|
| Unbeaufsichtigtes Windows | Die Aktivierung erfolgt ohne Dialogfeld. Der aktuell angemeldete Benutzer ist aktiviert. | Die Aktivierung erfolgt ohne Dialogfeld. Der aktuell angemeldete Benutzer ist aktiviert. |
| Nichtsilent Windows | Ein Windows-Kennwortdialogfeld wird angezeigt. Der angegebene Benutzer wird aktiviert. | Ein Windows-Kennwortdialogfeld wird angezeigt. Der angegebene Benutzer wird aktiviert. |
| Automatische Windows Live ID | Nicht zulässig. | Nicht zulässig. |
| Nichtsilent Windows Live ID | Ein Windows Live ID-Anmeldefenster wird angezeigt. Der angegebene Benutzer wird aktiviert. | Ein Windows Live ID-Anmeldefenster wird angezeigt. Der angegebene Benutzer wird aktiviert. |
Während der Ausführung ruft DRMActivate die benutzerdefinierte Rückruffunktion auf und legt den msg-Parameter auf DRM_MSG_ACTIVATE_MACHINE oder DRM_MSG_ACTIVATE_GROUPIDENTITY fest. Weitere Informationen finden Sie unter Erstellen einer Rückruffunktion.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | msdrm.h |
| Bibliothek | Msdrm.lib |
| DLL | Msdrm.dll |