AuthzModifySids-Funktion (authz.h)

Die AuthzModifySids-Funktion fügt Benutzer- und Gerätegruppen im Authz-Clientkontext hinzu, löscht oder ändert sie.

Syntax

AUTHZAPI BOOL AuthzModifySids(
  [in]           AUTHZ_CLIENT_CONTEXT_HANDLE     hAuthzClientContext,
  [in]           AUTHZ_CONTEXT_INFORMATION_CLASS SidClass,
  [in]           PAUTHZ_SID_OPERATION            pSidOperations,
  [in, optional] PTOKEN_GROUPS                   pSids
);

Parameter

[in] hAuthzClientContext

Ein Handle für den zu ändernden Clientkontext.

[in] SidClass

Typ der zu ändernden Informationen. Der Aufrufer kann AuthzContextInfoGroupsSids, AuthzContextInfoRestrictedSids oder AuthzContextInfoDeviceSids angeben.

[in] pSidOperations

Ein Zeiger auf ein Array von AUTHZ_SID_OPERATION Enumerationswerten, die die vorzunehmenden Gruppenänderungen angeben.

[in, optional] pSids

Ein Zeiger auf eine TOKEN_GROUPS-Struktur , die die zu ändernden Gruppen angibt.

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.

Hinweise

Die AUTHZ_SID_OPERATION-Enumeration darf nur ein Element enthalten, wenn der Wert dieses Elements AUTHZ_SID_OPERATION_REPLACE_ALL ist. Andernfalls verfügt das Array über die gleiche Anzahl von Elementen wie die entsprechende PTOKEN_GROUPS.

Wenn Sie AuthzModifySids zum Löschen verwenden möchten, werden die SIDs übereinstimmen, aber nicht die SID-Flags. Wenn keine übereinstimmende SID gefunden wird, werden keine Änderungen vorgenommen, und der Aufruf schlägt fehl.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	authz.h
Bibliothek	Authz.lib
DLL	Authz.dll