Función CopySid (securitybaseapi.h)

Artículo
03/05/2024

La función CopySid copia un identificador de seguridad (SID) en un búfer.

Sintaxis

BOOL CopySid(
  [in]  DWORD nDestinationSidLength,
  [out] PSID  pDestinationSid,
  [in]  PSID  pSourceSid
);

Parámetros

[in] nDestinationSidLength

Especifica la longitud, en bytes, del búfer que recibe la copia del SID.

[out] pDestinationSid

Puntero a un búfer que recibe una copia de la estructura del SID de origen.

[in] pSourceSid

Puntero a una estructura SID que la función copia en el búfer al que apunta el parámetro pDestinationSid .

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

Una aplicación puede usar la función CopySid para realizar una copia de un SID en un token de acceso (por ejemplo, en una estructura de TOKEN_GROUPS ) para usarla en una entrada de control de acceso (ACE).

Ejemplos

Para obtener un ejemplo que usa esta función, consulte Obtención del SID de inicio de sesión.

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