Función LookupAccountSidLocalA (winbase.h)

Artículo
11/20/2024

LookupAccountSidLocalA se define como una macro que llama a LookupAccountSidA con NULL como primer parámetro. Recupera el nombre de la cuenta del SID especificado en el equipo local.

Sintaxis

BOOL LookupAccountSidLocalA(
  [in]            PSID          Sid,
  [out, optional] LPSTR         Name,
  [in, out]       LPDWORD       cchName,
  [out, optional] LPSTR         ReferencedDomainName,
  [in, out]       LPDWORD       cchReferencedDomainName,
  [out]           PSID_NAME_USE peUse
);

Parámetros

[in] Sid

Puntero al SID que se va a buscar.

[out, optional] Name

Puntero a un búfer que recibe un cadena terminadanull que contiene el nombre de cuenta que corresponde al parámetro de lpSid.

[in, out] cchName

En la entrada, especifica el tamaño, en TCHARs, del búfer de lpName. Si se produce un error en la función porque el búfer es demasiado pequeño o si cchName es cero, cchName recibe el tamaño de búfer necesario, incluido el carácter nulo de terminación.

[out, optional] ReferencedDomainName

Puntero a un búfer que recibe un cadena terminadanull que contiene el nombre del dominio donde se encontró el nombre de la cuenta.

En un servidor, el nombre de dominio devuelto para la mayoría de las cuentas de la base de datos de seguridad del equipo local es el nombre del dominio para el que el servidor es un controlador de dominio.

En una estación de trabajo, el nombre de dominio devuelto para la mayoría de las cuentas de la base de datos de seguridad del equipo local es el nombre del equipo a partir del último inicio del sistema (se excluyen las barras diagonales inversas). Si cambia el nombre del equipo, el nombre anterior continúa devolviéndose como nombre de dominio hasta que se reinicie el sistema.

Algunas cuentas están predefinidas por el sistema. El nombre de dominio devuelto para estas cuentas es BUILTIN.

[in, out] cchReferencedDomainName

En la entrada, especifica el tamaño, en TCHARs, del búfer de lpReferencedDomainName. Si se produce un error en la función porque el búfer es demasiado pequeño o si cchReferencedDomainName es cero, cchReferencedDomainName recibe el tamaño de búfer necesario, incluida la terminación carácter nulo.

[out] peUse

Puntero a una variable que recibe un valor de SID_NAME_USE que indica el tipo de la cuenta.

Valor devuelto

Si la función se ejecuta correctamente, la función devuelve un valor distinto de cero.

Si se produce un error en la función, devuelve cero. Para obtener información de error extendida, llame a GetLastError.

Observaciones

Esta función es similar a LookupAccountSid, pero restringe la búsqueda a la máquina local.

Nota

El encabezado winbase.h define LookupAccountSidLocal 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	winbase.h (incluya Windows.h)