AuthzModifyClaims 函式 (authz.h)

  • 發行項

AuthzModifyClaims 函式會在 Authz 用戶端內容中新增、刪除或修改使用者和裝置宣告。

語法

AUTHZAPI BOOL AuthzModifyClaims(
  [in]           AUTHZ_CLIENT_CONTEXT_HANDLE            hAuthzClientContext,
  [in]           AUTHZ_CONTEXT_INFORMATION_CLASS        ClaimClass,
  [in]           PAUTHZ_SECURITY_ATTRIBUTE_OPERATION    pClaimOperations,
  [in, optional] PAUTHZ_SECURITY_ATTRIBUTES_INFORMATION pClaims
);

參數

[in] hAuthzClientContext

要修改之客戶端內容的句柄。

[in] ClaimClass

要修改的信息類型。 呼叫端可以指定 AuthzContextInfoUserClaims 或 AuthzContextInfoDeviceClaims。

[in] pClaimOperations

AUTHZ_SECURITY_ATTRIBUTE_OPERATION列舉值的陣列指標，指定要修改宣告的類型。

[in, optional] pClaims

指定要修改之宣告 之AUTHZ_SECURITY_ATTRIBUTES_INFORMATION 結構的指標。

傳回值

如果函式成功，則會傳回 TRUE。

如果函式失敗，則會傳回 FALSE。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。

備註

如果該專案的值AUTHZ_SECURITY_ATTRIBUTE_OPERATION_REPLACE_ALL，則 AUTHZ_SECURITY_ATTRIBUTE_OPERATION 列舉必須只有一個專案。 否則，陣列的元素數目與對應的PAUTHZ_SECURITY_ATTRIBUTES_INFORMATION相同。

如果 AUTHZ_SECURITY_ATTRIBUTE_OPERATION 列舉AUTHZ_SECURITY_ATTRIBUTE_OPERATION_REPLACE且函式失敗，請呼叫 GetLastError。 如果錯誤碼ERROR_ALREADY_EXISTS，宣告的值會有重複的專案。

規格需求

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