AuthzAddSidsToContext-Funktion (authz.h)

Die AuthzAddSidsToContext-Funktion erstellt eine Kopie eines vorhandenen Kontexts und fügt einen bestimmten Satz von Sicherheits-IDs (SIDs) und eingeschränkten SIDs an.

Syntax

AUTHZAPI BOOL AuthzAddSidsToContext(
  [in]  AUTHZ_CLIENT_CONTEXT_HANDLE  hAuthzClientContext,
  [in]  PSID_AND_ATTRIBUTES          Sids,
  [in]  DWORD                        SidCount,
  [in]  PSID_AND_ATTRIBUTES          RestrictedSids,
  [in]  DWORD                        RestrictedSidCount,
  [out] PAUTHZ_CLIENT_CONTEXT_HANDLE phNewAuthzClientContext
);

Parameter

[in] hAuthzClientContext

Eine AUTHZ_CLIENT_CONTEXT_HANDLE Struktur, die als Grundlage für NewClientContext kopiert werden soll.

[in] Sids

Ein Zeiger auf eine SID_AND_ATTRIBUTES-Struktur , die die SIDs und Attribute enthält, die dem uneingeschränkten Teil des Clientkontexts hinzugefügt werden sollen.

[in] SidCount

Die Anzahl der hinzuzufügenden SIDs.

[in] RestrictedSids

Ein Zeiger auf eine SID_AND_ATTRIBUTES-Struktur , die die SIDs und Attribute enthält, die dem eingeschränkten Teil des Clientkontexts hinzugefügt werden sollen.

[in] RestrictedSidCount

Anzahl der hinzuzufügenden eingeschränkten SIDs.

[out] phNewAuthzClientContext

Ein Zeiger auf die erstellte AUTHZ_CLIENT_CONTEXT_HANDLE Struktur, die Eingabewerte für Ablaufzeit, Bezeichner, Flags, zusätzliche SIDs und eingeschränkte SIDs enthält.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird TRUE zurückgegeben.

Wenn die Funktion fehlschlägt, wird FALSE zurückgegeben. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	authz.h
Bibliothek	Authz.lib
DLL	Authz.dll
Verteilbare Komponente	Windows Server 2003 Administration Tools Pack unter Windows XP

Weitere Informationen

Grundlegende Access Control-Funktionen

SID_AND_ATTRIBUTES