DRMGetUserInfo-Funktion (msdrm.h)
[Das AD RMS SDK, das Funktionen nutzt, die von
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. Es kann geändert oder geändert werden.
In nachfolgenden Versionen nicht verfügbar. Verwenden Sie stattdessen Active Directory Rights Management Services SDK 2.1,
die funktionen, die vom Client in Msipc.dll verfügbar gemacht werden.]
Die DRMGetUserInfo-Funktion erhält Informationen zu einem Benutzer.
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
Der Umgang des Benutzers, um Informationen zu erhalten.
[in, out] puUserNameLength
Ein Zeiger auf einen UINT-Wert , der im Eintrag die Länge in Zeichen des wszUserName-Puffers enthält. Diese Länge muss das endende Nullzeichen enthalten.
Nachdem die Funktion zurückgegeben wurde, enthält dieser Wert die Anzahl der Zeichen, einschließlich des terminierenden Nullzeichens, die in den wszUserName-Puffer kopiert wurden.
[out] wszUserName
Ein Zeiger auf eine null-beendete Unicode-Zeichenfolge, die den Benutzernamen als vollqualifizierte SMTP-E-Mail-Adresse empfängt. Dies wird nicht erzwungen oder verwendet, um Identitäten zu überprüfen; es ist nur enthalten, um eine menschliche lesbare Identifizierung bereitzustellen. Die Größe dieses Puffers wird vom puUserNameLength-Parameter angegeben.
Um die erforderliche Größe dieses Puffers zu ermitteln, übergeben Sie NULL für diesen Parameter. Die Funktion platziert die Größe in Zeichen, einschließlich des terminierenden Nullzeichens, im puUserNameLength-Wert .
[in, out] puUserIdLength
Ein Zeiger auf einen UINT-Wert , der im Eintrag die Länge in Zeichen des wszUserId-Puffers enthält. Diese Länge muss das endende Nullzeichen enthalten.
Nachdem die Funktion zurückgegeben wurde, enthält dieser Wert die Anzahl der Zeichen, einschließlich des terminierenden Nullzeichens, die in den wszUserId-Puffer kopiert wurden.
[out] wszUserId
Ein Zeiger auf eine null-beendete Unicode-Zeichenfolge, die die ID des Benutzers empfängt. Die Größe dieses Puffers wird vom puUserIdLength-Parameter angegeben.
Um die erforderliche Größe dieses Puffers zu ermitteln, übergeben Sie NULL für diesen Parameter. Die Funktion platziert die Größe in Zeichen, einschließlich des terminierenden Nullzeichens, im puUserIdLength-Wert .
[in, out] puUserIdTypeLength
Ein Zeiger auf einen UINT-Wert , der im Eintrag die Länge in Zeichen des wszUserIdType-Puffers enthält. Diese Länge muss das endende Nullzeichen enthalten.
Nachdem die Funktion zurückgegeben wurde, enthält dieser Wert die Anzahl der Zeichen, einschließlich des terminierenden Nullzeichens, die in den wszUserIdType-Puffer kopiert wurden.
[out] wszUserIdType
Ein Zeiger auf eine null-beendete Unicode-Zeichenfolge, 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 vom puUserIdTypeLength-Parameter angegeben.
Um die erforderliche Größe dieses Puffers zu ermitteln, übergeben Sie NULL für diesen Parameter. Die Funktion platziert die Größe in Zeichen, einschließlich des terminierenden Nullzeichens, im puUserIdTypeLength-Wert .
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 umfassen, aber nicht beschränkt auf diejenigen 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 mit wszUserName, wszUserId und wszUserIdType auf NULL aufrufen, um die erforderlichen Puffergrößen über puUserNameLength,puUserIdLength und puUserIdTypeLength und puUserIdTypeLength abzurufen. Es ist die Verantwortung der Anwendung, Speicherplatz zuzuweisen und frei zu puffern.
Anforderungen
| Zielplattform | Windows |
| Kopfzeile | msdrm.h |
| Bibliothek | Msdrm.lib |
| DLL | Msdrm.dll |