Compartilhar via


Função AuthzModifySids (authz.h)

A função AuthzModifySids adiciona, exclui ou modifica grupos de usuários e dispositivos no contexto do cliente Authz.

Sintaxe

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

Parâmetros

[in] hAuthzClientContext

Um identificador para o contexto do cliente a ser modificado.

[in] SidClass

Tipo de informação a ser modificada. O chamador pode especificar AuthzContextInfoGroupsSids, AuthzContextInfoRestrictedSids ou AuthzContextInfoDeviceSids.

[in] pSidOperations

Um ponteiro para uma matriz de AUTHZ_SID_OPERATION valores de enumeração que especificam as modificações de grupo a serem feitas.

[in, optional] pSids

Um ponteiro para uma estrutura TOKEN_GROUPS que especifica os grupos a serem modificados.

Retornar valor

Se a função for bem-sucedida, ela retornará TRUE.

Se a função falhar, ela retornará FALSE. Para obter informações de erro estendidas, chame GetLastError.

Comentários

A enumeração AUTHZ_SID_OPERATION deve ter apenas um elemento se o valor desse elemento for AUTHZ_SID_OPERATION_REPLACE_ALL. Caso contrário, a matriz terá o mesmo número de elementos que o PTOKEN_GROUPS correspondente.

Quando você deseja usar AuthzModifySids para excluir, os SIDs são correspondidos, mas não os sinalizadores sid. Se nenhum SID correspondente for encontrado, nenhuma modificação será feita e a chamada falhará.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho authz.h
Biblioteca Authz.lib
DLL Authz.dll