Compartilhar via


Função InitializeSid (securitybaseapi.h)

A função InitializeSid inicializa um SID ( identificador de segurança ).

Sintaxe

BOOL InitializeSid(
  [out] PSID                      Sid,
  [in]  PSID_IDENTIFIER_AUTHORITY pIdentifierAuthority,
  [in]  BYTE                      nSubAuthorityCount
);

Parâmetros

[out] Sid

Um ponteiro para uma estrutura sid a ser inicializada.

[in] pIdentifierAuthority

Um ponteiro para uma estrutura SID_IDENTIFIER_AUTHORITY a ser definida na estrutura sid.

[in] nSubAuthorityCount

Especifica o número de subautoridades a serem definidas no SID. Os valores da subautoridade devem ser definidos separadamente, conforme descrito na seção Comentários a seguir.

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

Embora a função InitializeSid defina o número de subpropriedades para o SID, ela não define os valores de subautoridade. Isso deve ser feito separadamente, usando funções como GetSidSubAuthority.

Um aplicativo pode usar a função AllocateAndInitializeSid para inicializar um SID e definir seus valores de subautoridade.

Essa função usa um valor RID de 32 bits. Para aplicativos que exigem um valor RID maior, use CreateWellKnownSid.

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 de Controle de Acesso básicas

CreateWellKnownSid

GetLengthSid

GetSidIdentifierAuthority

GetSidLengthRequired

GetSidSubAuthority

GetSidSubAuthorityCount

IsValidSid

SID

SID_IDENTIFIER_AUTHORITY