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 |