Função DeriveCapabilitySidsFromName (securitybaseapi.h)

Essa função constrói duas matrizes de SIDs a partir de um nome de funcionalidade. Um é um SID de grupo de matrizes com Autoridade NT e o outro é uma matriz de SIDs de recursos com AppAuthority.

Sintaxe

BOOL DeriveCapabilitySidsFromName(
  [in]  LPCWSTR CapName,
  [out] PSID    **CapabilityGroupSids,
  [out] DWORD   *CapabilityGroupSidCount,
  [out] PSID    **CapabilitySids,
  [out] DWORD   *CapabilitySidCount
);

Parameters

[in] CapName

Nome da funcionalidade no formulário de cadeia de caracteres.

[out] CapabilityGroupSids

Os GroupSids com NTAuthority.

[out] CapabilityGroupSidCount

A contagem de GroupSids na matriz.

[out] CapabilitySids

CapabilitySids com AppAuthority.

[out] CapabilitySidCount

A contagem de CapabilitySid com AppAuthority.

Valor de devolução

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.

Observações

Espera-se que o chamador libere os SIDs individuais retornados em cada matriz chamando LocalFree, bem como a memória alocada para a própria matriz.

O SID computado para o recurso de aplicativo de recursos herdados (publicado antes do Win10) será o mesmo que os SIDs publicados, mas o SID para o SID de funcionalidade do grupo de serviços será baseado em hash.

Requirements

Requirement	Valor
Cliente mínimo suportado	Windows XP [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo compatível	Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP]
da Plataforma de Destino	Windows
Cabeçalho	securitybaseapi.h (inclua Windows.h)
Biblioteca	OneCoreUAP.lib
de DLL	KernelBase.dll