DeriveCapabilitySidsFromName-Funktion (securitybaseapi.h)

Artikel
01.03.2024

Diese Funktion erstellt zwei Arrays von SIDs aus einem Funktionsnamen. Die eine ist eine Arraygruppen-SID mit NT-Autorität, die andere 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 von CapabilitySid mit AppAuthority.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt sie TRUE zurück.

Wenn die Funktion fehlschlägt, gibt sie FALSE zurück. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Es wird erwartet, dass der Aufrufer die einzelnen SIDs freigibt, die in jedem Array zurückgegeben werden, indem er aufruft LocalFree, sowie den für das Array selbst zugewiesenen Arbeitsspeicher.

Die SID, die für die Anwendungsfunktion von Legacyfunktionen berechnet wurde (vor Win10 veröffentlicht), ist identisch mit den veröffentlichten SIDs, aber die SID für die Dienstgruppenfunktions-SID basiert auf Hash.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	securitybaseapi.h (einschließlich Windows.h)
Bibliothek	Advapi32.lib
DLL	Kernel32.dll

Freigeben über