Función BuildTrusteeWithSidA (aclapi.h)

Artículo
11/20/2024

La función buildTrusteeWithSid inicializa una estructura de de TRUSTEE. El autor de la llamada especifica el identificador de seguridad (SID) del administrador de confianza. La función establece otros miembros de la estructura en valores predeterminados y no busca el nombre asociado al SID.

Sintaxis

void BuildTrusteeWithSidA(
  [in, out]      PTRUSTEE_A pTrustee,
  [in, optional] PSID       pSid
);

Parámetros

[in, out] pTrustee

Puntero a una estructura de TRUSTEE que se va a inicializar. La función BuildTrusteeWithSid no asigna memoria. Si este parámetro es null o un puntero que no es válido, los resultados no están definidos.

[in, optional] pSid

Puntero a una estructura SID que identifica al administrador de confianza. La función BuildTrusteeWithSid asigna este puntero al miembro ptstrName de la estructura de TRUSTEE. La función establece los demás miembros de la estructura TRUSTEE como se indica a continuación.

Valor	Significado
pMultipleTrustee	NULL
multipleTrusteeOperation	NO_MULTIPLE_TRUSTEE
trusteeForm	TRUSTEE_IS_SID
de TrusteeType	TRUSTEE_IS_UNKNOWN

Valor devuelto

Ninguno

Observaciones

Nota

El encabezado aclapi.h define BuildTrusteeWithSid como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	aclapi.h
biblioteca de	Advapi32.lib
DLL de	Advapi32.dll