Função CopySid (securitybaseapi.h)

Artigo
03/01/2024

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