Condividi tramite


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

AllocateAndInitializeSid

Funzioni di base Controllo di accesso

EqualSid

GetLengthSid

GetSidIdentifierAuthority

GetSidLengthRequired

GetSidSubAuthority

GetSidSubAuthorityCount

InizializzaSid

IsValidSid

SID