Função InitializeSid (securitybaseapi.h)

Artigo
03/01/2024

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