Funzione CopySid (securitybaseapi.h)

Articolo
03/01/2024

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