Freigeben über


CopySid-Funktion (securitybaseapi.h)

Die CopySid-Funktion kopiert einen Sicherheitsbezeichner (Security Identifier , SID) in einen Puffer.

Syntax

BOOL CopySid(
  [in]  DWORD nDestinationSidLength,
  [out] PSID  pDestinationSid,
  [in]  PSID  pSourceSid
);

Parameter

[in] nDestinationSidLength

Gibt die Länge des Puffers, der die Kopie der SID empfängt, in Bytes an.

[out] pDestinationSid

Ein Zeiger auf einen Puffer, der eine Kopie der Quell-SID-Struktur empfängt.

[in] pSourceSid

Ein Zeiger auf eine SID-Struktur , die die Funktion in den Puffer kopiert, auf den der pDestinationSid-Parameter verweist.

Rückgabewert

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

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

Hinweise

Eine Anwendung kann die CopySid-Funktion verwenden, um eine Kopie einer SID in einem Zugriffstoken (z. B. in einer TOKEN_GROUPS-Struktur ) zu erstellen, die in einem Zugriffssteuerungseintrag (Access Control Entry, ACE) verwendet werden soll.

Beispiele

Ein Beispiel, das diese Funktion verwendet, finden Sie unter Abrufen der Anmelde-SID.

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

Weitere Informationen

Zugriffssteuerung Übersicht

AllocateAndInitializeSid

Grundlegende Access Control-Funktionen

EqualSid

GetLengthSid

GetSidIdentifierAuthority

GetSidLengthRequired

GetSidSubAuthority

GetSidSubAuthorityCount

InitializeSid

IsValidSid

SID