Compartir a través de

Función DeriveCapabilitySidsFromName (securitybaseapi.h)

  • Artículo

Esta función construye dos matrices de SID fuera de un nombre de funcionalidad. Uno es un SID de grupo de matrices con NT Authority y el otro es una matriz de SID de funcionalidad con AppAuthority.

Sintaxis

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

Parámetros

[in] CapName

Nombre de la funcionalidad en forma de cadena.

[out] CapabilityGroupSids

GroupSids con NTAuthority.

[out] CapabilityGroupSidCount

Recuento de GroupSids en la matriz.

[out] CapabilitySids

CapabilitySids con AppAuthority.

[out] CapabilitySidCount

Recuento de CapabilitySid con AppAuthority.

Valor devuelto

Si la función se ejecuta correctamente, devuelve TRUE.

Si se produce un error en la función, devuelve FALSE. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Se espera que el autor de la llamada libere los SID individuales devueltos en cada matriz mediante una llamada a LocalFree, así como la memoria asignada para la propia matriz.

El SID calculado para la funcionalidad de la aplicación de las funcionalidades heredadas (publicadas antes de Win10) será el mismo que los SID publicados, pero el SID para el SID de funcionalidad del grupo de servicios se basará en hash.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2003 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino Windows
Encabezado securitybaseapi.h (incluya Windows.h)
Library Advapi32.lib
Archivo DLL Kernel32.dll