DRMGetUserInfo-Funktion (msdrm.h)

  • Artikel

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

der Client in Msdrm.dll für die Verwendung in Windows Server 2008, Windows Vista, Windows Server 2008 R2, Windows 7, Windows Server 2012 und Windows 8 verfügbar ist. 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 DRMGetUserInfo-Funktion ruft Informationen zu einem Benutzer ab.

Syntax

DRMEXPORT HRESULT UDAPICALL DRMGetUserInfo(
  [in]      DRMPUBHANDLE hUser,
  [in, out] UINT         *puUserNameLength,
  [out]     PWSTR        wszUserName,
  [in, out] UINT         *puUserIdLength,
  [out]     PWSTR        wszUserId,
  [in, out] UINT         *puUserIdTypeLength,
  [out]     PWSTR        wszUserIdType
);

Parameter

[in] hUser

Das Handle des Benutzers, für den Informationen abgerufen werden sollen.

[in, out] puUserNameLength

Ein Zeiger auf einen UINT-Wert , der bei einem Eintrag die Länge des wszUserName-Puffers in Zeichen enthält. Diese Länge muss das endende NULL-Zeichen enthalten.

Nach der Rückgabe der Funktion enthält dieser Wert die Anzahl der Zeichen, einschließlich des abschließenden NULL-Zeichens, die in den wszUserName-Puffer kopiert wurden.

[out] wszUserName

Ein Zeiger auf eine Unicode-Zeichenfolge mit NULL-Termin, die den Benutzernamen als vollqualifizierte SMTP-E-Mail-Adresse empfängt. Dies wird nicht erzwungen oder verwendet, um Identitäten zu überprüfen. sie ist nur enthalten, um eine lesbare Identifizierung bereitzustellen. Die Größe dieses Puffers wird durch den puUserNameLength-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 abschließenden NULL-Zeichens, in den Wert puUserNameLength .

[in, out] puUserIdLength

Ein Zeiger auf einen UINT-Wert , der bei einem Eintrag die Länge des wszUserId-Puffers in Zeichen enthält. Diese Länge muss das endende NULL-Zeichen enthalten.

Nach der Rückgabe der Funktion enthält dieser Wert die Anzahl der Zeichen, einschließlich des abschließenden NULL-Zeichens, die in den wszUserId-Puffer kopiert wurden.

[out] wszUserId

Ein Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die die BENUTZER-ID empfängt. Die Größe dieses Puffers wird durch den puUserIdLength-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 abschließenden NULL-Zeichens, im puUserIdLength-Wert .

[in, out] puUserIdTypeLength

Ein Zeiger auf einen UINT-Wert , der bei einem Eintrag die Länge des wszUserIdType-Puffers in Zeichen enthält. Diese Länge muss das endende NULL-Zeichen enthalten.

Nach der Rückgabe der Funktion enthält dieser Wert die Anzahl der Zeichen, einschließlich des abschließenden NULL-Zeichens, die in den wszUserIdType-Puffer kopiert wurden.

[out] wszUserIdType

Ein Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die den Typ der ID empfängt, die zum Identifizieren des Benutzers verwendet wird (z. B. Passport, Windows oder andere). Die Größe dieses Puffers wird durch den puUserIdTypeLength-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 abschließenden NULL-Zeichens, in den PuUserIdTypeLength-Wert .

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

Weitere Informationen zu Benutzer-IDs und ID-Typen finden Sie unter DRMCreateUser.

Wenn Sie die Ausgabewerte abrufen, können Sie diese Funktion zuerst aufrufen, wobei wszUserName, wszUserId und wszUserIdType auf NULL festgelegt sind, um die erforderlichen Puffergrößen über puUserNameLength, puUserIdLength und puUserIdTypeLength abzurufen. Es liegt in der Verantwortung der Anwendung, Pufferspeicherplatz zuzuweisen und frei zu geben.

Requirements (Anforderungen)

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

Weitere Informationen

AD RMS-Funktionen

DRMCreateUser

DRMGetUsers