CopySid-Funktion (securitybaseapi.h)

Artikel
03/01/2024

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