Share via

ISecurityCallContext::IsUserInRole-Methode (comsvcs.h)

  • Artikel

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
S_OK
 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.
CONTEXT_E_ROLENOTFOUND
 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

Weitere Informationen

ISecurityCallContext

Programmgesteuerte Komponentensicherheit