Função CopySid (securitybaseapi.h)
A função CopySid copia um SID ( identificador de segurança ) para um buffer.
Sintaxe
BOOL CopySid(
[in] DWORD nDestinationSidLength,
[out] PSID pDestinationSid,
[in] PSID pSourceSid
);
Parâmetros
[in] nDestinationSidLength
Especifica o comprimento, em bytes, do buffer que recebe a cópia do SID.
[out] pDestinationSid
Um ponteiro para um buffer que recebe uma cópia da estrutura sid de origem.
[in] pSourceSid
Um ponteiro para uma estrutura SID que a função copia para o buffer apontado pelo parâmetro pDestinationSid .
Valor retornado
Se a função for bem-sucedida, o valor retornado será diferente de zero.
Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.
Comentários
Um aplicativo pode usar a função CopySid para fazer uma cópia de um SID em um token de acesso (por exemplo, em uma estrutura TOKEN_GROUPS ) para usar em uma ACE (entrada de controle de acesso).
Exemplos
Para obter um exemplo que usa essa função, consulte Obtendo o SID de logon.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP [aplicativos da área de trabalho | aplicativos UWP] |
| Servidor mínimo com suporte | Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | securitybaseapi.h (inclua Windows.h) |
| Biblioteca | Advapi32.lib |
| DLL | Advapi32.dll |
Confira também
Visão geral do Controle de Acesso