Compartilhar via


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

AllocateAndInitializeSid

Funções básicas de Controle de Acesso

EqualSid

GetLengthSid

GetSidIdentifierAuthority

GetSidLengthRequired

GetSidSubAuthority

GetSidSubAuthorityCount

InitializeSid

IsValidSid

SID