ISecurityCallContext::IsUserInRole-Methode (comsvcs.h)
Bestimmt, ob der angegebene Benutzer der angegebenen Rolle angehört.
Syntax
HRESULT IsUserInRole(
[in] VARIANT *pUser,
[in] BSTR bstrRole,
[out] VARIANT_BOOL *pfInRole
);
Parameter
[in] pUser
Ein Zeiger auf den Wert, der die Benutzer-ID des Benutzers enthält, dessen Rollenmitgliedschaft überprüft werden soll. Wenn Sie beabsichtigen, die Sicherheits-ID (SID) an IsUserInRole zu übergeben, sollte dieser Parameter die folgenden Anforderungen erfüllen: V_VT(pUser) == (VT_ARRAY|VT_UI1) && V_ARRAY(pUser)->cDims == 1.
[in] bstrRole
Der Name der Rolle.
[out] pfInRole
TRUE , wenn sich der Benutzer in der angegebenen Rolle befindet; FALSE , wenn nicht. Wenn die angegebene Rolle nicht für die Anwendung definiert ist, wird FALSE zurückgegeben. Dieser Parameter ist auf TRUE festgelegt, wenn die rollenbasierte Sicherheit nicht aktiviert ist.
Rückgabewert
Diese Methode kann die Standardrückgabewerte E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED und E_FAIL sowie die folgenden Werte zurückgeben.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Die im bstrRole-Parameter angegebene Rolle ist eine erkannte Rolle, und das boolesche Ergebnis, das im pfIsInRole-Parameter zurückgegeben wird, gibt an, ob der Benutzer in dieser Rolle ist. |
|
Die im bstrRole-Parameter angegebene Rolle ist nicht vorhanden. |
Hinweise
Verwenden Sie diese Methode, um den Zugriff auf Codeabschnitte zu beschränken, die nicht ausgeführt werden sollen, es sei denn, der Aufrufer ist Mitglied der angegebenen Rolle. Windows-Gruppen und -Benutzer werden den Rollen einer Anwendung mithilfe des Verwaltungstools für Komponentendienste zugewiesen. Weitere Informationen zu Rollen finden Sie unter Rollenbasierte Sicherheit.
Da IsUserInRoleTRUE ist, wenn die rollenbasierte Sicherheit nicht aktiviert ist, empfiehlt es sich, IsSecurityEnabled aufzurufen, bevor IsUserInRole aufgerufen wird, um sicherzustellen, dass IsUserInRole nützliche Informationen zurückgibt.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | comsvcs.h |