Freigeben über


CreateWellKnownSid-Funktion (securitybaseapi.h)

Die CreateWellKnownSid-Funktion erstellt eine SID für vordefinierte Aliase.

Syntax

BOOL CreateWellKnownSid(
  [in]            WELL_KNOWN_SID_TYPE WellKnownSidType,
  [in, optional]  PSID                DomainSid,
  [out, optional] PSID                pSid,
  [in, out]       DWORD               *cbSid
);

Parameter

[in] WellKnownSidType

Member der WELL_KNOWN_SID_TYPE-Enumeration , die angibt, was die SID identifizieren soll.

[in, optional] DomainSid

Ein Zeiger auf eine SID, die die Domäne identifiziert, die beim Erstellen der SID verwendet werden soll. Übergeben Sie NULL , um den lokalen Computer zu verwenden.

[out, optional] pSid

Ein Zeiger auf den Arbeitsspeicher, in dem CreateWellKnownSid die neue SID speichert.

[in, out] cbSid

Ein Zeiger auf ein DWORD , das die Anzahl der bei pSid verfügbaren Bytes enthält. Die CreateWellKnownSid-Funktion speichert die Anzahl der Bytes, die an diesem Speicherort tatsächlich verwendet werden.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen zu erhalten.

Anforderungen

   
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 Advapi32.dll

Weitere Informationen

EqualDomainSid

GetWindowsAccountDomainSid

IsWellKnownSid

WELL_KNOWN_SID_TYPE