Função LsaGetAppliedCAPIDs (ntlsa.h)

  • Artigo

A função LsaGetAppliedCAPIDs retorna uma matriz de CAPIDs (identificadores de POLÍTICAS de Acesso Central) de todos os CAPs aplicados em um computador específico.

Sintaxe

NTSTATUS LsaGetAppliedCAPIDs(
  [in, optional] PLSA_UNICODE_STRING SystemName,
  [out]          PSID                **CAPIDs,
  [out]          PULONG              CAPIDCount
);

Parâmetros

[in, optional] SystemName

Um ponteiro para uma estrutura LSA_UNICODE_STRING que contém o nome do computador específico. O nome pode ter a forma de "ComputerName" ou "\ComputerName". Se esse parâmetro for NULL, a função retornará os CAPIDs do computador local.

[out] CAPIDs

Um ponteiro para uma variável que recebe uma matriz de ponteiros para CAPIDs que identificam os CAPs disponíveis no computador especificado. Quando terminar de usar os CAPIDs, chame a função LsaFreeMemory em cada elemento na matriz e em toda a matriz.

[out] CAPIDCount

Um ponteiro para uma variável que recebe o número de CAPs disponíveis no computador especificado. A matriz retornada no parâmetro CAPIDs contém o mesmo número de elementos que o parâmetro CAPIDCount .

Retornar valor

Se a função for bem-sucedida, o valor retornado será STATUS_SUCCESS.

Se a função falhar, o valor retornado será um dos valores retornados da função de política LSA. Você pode usar a função LsaNtStatusToWinError para converter o código NTSTATUS em um código de erro do Windows.

Comentários

Para obter detalhes específicos sobre as políticas de acesso central, você pode consultar os atributos do objeto de política de acesso central no Active Directory no controlador de domínio do computador especificado. Procure o objeto cujo atributo msAuthz-CentralAccessPolicyID corresponde a um dos CAPIDs retornados.

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 ntlsa.h
Biblioteca Advapi32.lib
DLL Advapi32.dll

Confira também

Política de Autorização Centralizada