Función InitializeSid (securitybaseapi.h)

Artículo
03/01/2024

La función InitializeSid inicializa un identificador de seguridad (SID).

Sintaxis

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

Parámetros

[out] Sid

Puntero a una estructura de SID que se va a inicializar.

[in] pIdentifierAuthority

Puntero a una estructura de SID_IDENTIFIER_AUTHORITY que se va a establecer en la estructura del SID .

[in] nSubAuthorityCount

Especifica el número de subauthoridades que se van a establecer en el SID. Los valores de la subautenticación se deben establecer por separado, como se describe en la sección Comentarios siguiente.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Aunque la función InitializeSid establece el número de subauthoridades para el SID, no establece los valores de subauthoridad. Esto debe realizarse por separado, mediante funciones como GetSidSubAuthority.

Una aplicación puede usar la función AllocateAndInitializeSid para inicializar un SID y establecer sus valores de subauthoridad.

Esta función usa un valor RID de 32 bits. En el caso de las aplicaciones que requieren un valor RID mayor, use CreateWellKnownSid.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [aplicaciones de escritorio \| aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2003 [aplicaciones de escritorio \| aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	securitybaseapi.h (incluya Windows.h)
Library	Advapi32.lib
Archivo DLL	Advapi32.dll