Função LsaGetAppliedCAPIDs (ntlsa.h)
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 |