Compartilhar via


Função CreateWellKnownSid (securitybaseapi.h)

A função CreateWellKnownSid cria um SID para aliases predefinidos.

Sintaxe

BOOL CreateWellKnownSid(
  [in]            WELL_KNOWN_SID_TYPE WellKnownSidType,
  [in, optional]  PSID                DomainSid,
  [out, optional] PSID                pSid,
  [in, out]       DWORD               *cbSid
);

Parâmetros

[in] WellKnownSidType

Membro da enumeração WELL_KNOWN_SID_TYPE que especifica o que o SID identificará.

[in, optional] DomainSid

Um ponteiro para um SID que identifica o domínio a ser usado ao criar o SID. Passe NULL para usar o computador local.

[out, optional] pSid

Um ponteiro para a memória em que CreateWellKnownSid armazenará o novo SID.

[in, out] cbSid

Um ponteiro para um DWORD que contém o número de bytes disponíveis em pSid. A função CreateWellKnownSid armazena o número de bytes realmente usados neste local.

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.

Requisitos

   
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

EqualDomainSid

GetWindowsAccountDomainSid

IsWellKnownSid

WELL_KNOWN_SID_TYPE