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_REPLACE_ALL， 則AUTHZ_SID_OPERATION 列舉必須只有一個專案。 否則，陣列的元素數目與對應的PTOKEN_GROUPS相同。

當您想要使用 AuthzModifySids 刪除時，SID 會比對，但不會比對 SID 旗標。 如果找不到相符的 SID，則不會進行任何修改，而且呼叫會失敗。

規格需求

需求 值
最低支援的用戶端 Windows 8 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2012 [僅限傳統型應用程式]
目標平台 Windows
標頭 authz.h
程式庫 Authz.lib
Dll Authz.dll