DeriveCapabilitySidsFromName-Funktion (securitybaseapi.h)

Diese Funktion erstellt zwei Arrays von SIDs aus einem Funktionsnamen. Eine ist eine Arraygruppen-SID mit NT Authority, und die andere ist ein Array von Funktions-SIDs mit AppAuthority.

Syntax

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

Parameter

[in] CapName

Name der Funktion in Zeichenfolgenform.

[out] CapabilityGroupSids

Die GroupSids mit NTAuthority.

[out] CapabilityGroupSidCount

Die Anzahl der GroupSids im Array.

[out] CapabilitySids

CapabilitySids mit AppAuthority.

[out] CapabilitySidCount

Die Anzahl der CapabilitySid mit AppAuthority.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird WAHR zurückgegeben.

Wenn die Funktion fehlschlägt, wird FALSE zurückgegeben. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen abzurufen.

Bemerkungen

Der Aufrufer wird davon ausgegangen, dass die einzelnen SIDs, die in jedem Array zurückgegeben werden, durch Aufrufen LocalFreeund speicherzuweisung für das Array selbst freigegeben werden.

Die SID, die für die Anwendungsfunktion von Legacyfunktionen (veröffentlicht vor Win10) berechnet wird, ist identisch mit den veröffentlichten SIDs, die SID für die Dienstgruppenfunktions-SID wird jedoch hashbasiert.

Requirements