Compartilhar via


Função DeriveCapabilitySidsFromName (securitybaseapi.h)

Essa função constrói duas matrizes de SIDs com base em um nome de funcionalidade. Um é um SID de grupo de matrizes com autoridade NT e o outro é uma matriz de SIDs de funcionalidade com AppAuthority.

Sintaxe

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

Parâmetros

[in] CapName

Nome da funcionalidade no formato de cadeia de caracteres.

[out] CapabilityGroupSids

O GroupSids com NTAuthority.

[out] CapabilityGroupSidCount

A contagem de GroupSids na matriz.

[out] CapabilitySids

CapabilitySids com AppAuthority.

[out] CapabilitySidCount

A contagem de CapabilitySid com AppAuthority.

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

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 calculado para a funcionalidade de aplicativo dos 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.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [aplicativos da área de trabalho | aplicativos UWP]
Servidor mínimo com suporte Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho securitybaseapi.h (inclua Windows.h)
Biblioteca Advapi32.lib
DLL Kernel32.dll