Função EqualPrefixSid (securitybaseapi.h)

Artigo
03/01/2024

A função EqualPrefixSid testa dois valores de prefixo sid ( identificador de segurança ) para igualdade. Um prefixo SID é o SID inteiro, exceto pelo último valor de subautoridade.

Sintaxe

BOOL EqualPrefixSid(
  [in] PSID pSid1,
  [in] PSID pSid2
);

Parâmetros

[in] pSid1

Um ponteiro para a primeira estrutura sid a ser comparada. Essa estrutura é considerada válida.

[in] pSid2

Um ponteiro para a segunda estrutura sid a ser comparada. Essa estrutura é considerada válida.

Retornar valor

Se os prefixos sid forem iguais, o valor retornado será diferente de zero.

Se os prefixos sid não forem iguais, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

A função EqualPrefixSid permite que um aplicativo de servidor em um domínio verifique uma tentativa de um usuário de fazer logon em outro domínio. Por exemplo, se um usuário tentar fazer logon no RemoteDomain de uma estação de trabalho no LocalDomain, o servidor para LocalDomain poderá solicitar os SIDs para o usuário e os grupos do usuário do RemoteDomain. O controlador de domínio para RemoteDomain responde com os SIDs relevantes.

Todos os SIDs para um domínio especificado têm o mesmo prefixo. Quando o servidor recebe os SIDs do usuário, o servidor pode chamar a função EqualPrefixSid para cada SID, comparando o USUÁRIO ou o SID de grupo com o SID para RemoteDomain. Se qualquer um dos prefixos sid não for igual, o servidor recusará a tentativa de logon.

É aconselhável modificar o SID para um domínio antes de compará-lo com um GRUPO ou SID de usuário. Se o SID para RemoteDomain for S-1-1234-8, cada SID de grupo ou usuário para esse domínio terá S-1-1234-8 como seu prefixo. Para comparar os SIDs usando a função EqualPrefixSid , um aplicativo copia o SID de domínio e adiciona qualquer valor de SUBautoridade (RID) à cópia, criando assim um SID no formulário S-1-1234-8-0. Em seguida, o aplicativo usa o SID de domínio modificado como um modelo em relação ao qual os SIDs do grupo e do usuário são comparados.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	securitybaseapi.h (inclua Windows.h)
Biblioteca	Advapi32.lib
DLL	Advapi32.dll