Función LookupAccountSidLocalA (winbase.h)

Artículo
03/08/2023

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 una cadena terminada en null que contiene el nombre de cuenta que corresponde al parámetro lpSid .

[in, out] cchName

En la entrada, especifica el tamaño, en TCHARs, del búfer 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 una cadena terminada en null 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 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, incluido el carácter nulo de terminación.

[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.

Comentarios

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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winbase.h (incluya Windows.h)