Funzione CopySid (securitybaseapi.h)
La funzione CopySid copia un identificatore di sicurezza (SID) in un buffer.
Sintassi
BOOL CopySid(
[in] DWORD nDestinationSidLength,
[out] PSID pDestinationSid,
[in] PSID pSourceSid
);
Parametri
[in] nDestinationSidLength
Specifica la lunghezza, in byte, del buffer che riceve la copia del SID.
[out] pDestinationSid
Puntatore a un buffer che riceve una copia della struttura SID di origine.
[in] pSourceSid
Puntatore a una struttura SID copiata dal buffer a cui punta il parametro pDestinationSid .
Valore restituito
Se la funzione ha esito positivo, il valore restituito è diverso da zero.
Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
Un'applicazione può usare la funzione CopySid per creare una copia di un SID in un token di accesso (ad esempio, in una struttura di TOKEN_GROUPS ) da usare in una voce di controllo di accesso (ACE).
Esempio
Per un esempio che usa questa funzione, vedere Recupero del SID di accesso.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP [app desktop | App UWP] |
| Server minimo supportato | Windows Server 2003 [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Intestazione | securitybaseapi.h (include Windows.h) |
| Libreria | Advapi32.lib |
| DLL | Advapi32.dll |
Vedi anche
Panoramica Controllo di accesso