AuthzModifySids 関数 (authz.h)

AuthzModifySids 関数は、Authz クライアント コンテキストでユーザー グループとデバイス グループを追加、削除、または変更します。

構文

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
);

パラメーター

[in] hAuthzClientContext

変更するクライアント コンテキストへのハンドル。

[in] SidClass

変更する情報の種類。 呼び出し元は、AuthzContextInfoGroupsSids、AuthzContextInfoRestrictedSids、または AuthzContextInfoDeviceSids を指定できます。

[in] pSidOperations

グループの変更を指定 AUTHZ_SID_OPERATION 列挙値の配列へのポインター。

[in, optional] pSids

変更するグループを指定する TOKEN_GROUPS 構造体へのポインター。

戻り値

関数が成功すると、 TRUE が返されます。

関数が失敗すると、 FALSE が返されます。 詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

AUTHZ_SID_OPERATION列挙体は、その要素の値がAUTHZ_SID_OPERATION_REPLACE_ALL場合、1 つの要素のみを持つ必要があります。 それ以外の場合、配列には、対応するPTOKEN_GROUPSと同じ数の要素があります。

AuthzModifySids を使用して削除する場合、SID は一致しますが、SID フラグは一致しません。 一致する SID が見つからない場合、変更は行われず、呼び出しは失敗します。

要件