Función DeriveCapabilitySidsFromName (securitybaseapi.h)

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