Función ConvertSidToStringSidA (sddl.h)

Artículo
03/01/2024

La función ConvertSidToStringSid convierte un identificador de seguridad (SID) en un formato de cadena adecuado para mostrar, almacenar o transmitir.

Para volver a convertir el SID de formato de cadena en un SID funcional válido, llame a la función ConvertStringSidToSid .

Sintaxis

BOOL ConvertSidToStringSidA(
  [in]  PSID  Sid,
  [out] LPSTR *StringSid
);

Parámetros

[in] Sid

Puntero a la estructura de SID que se va a convertir.

[out] StringSid

Puntero a una variable que recibe un puntero a una cadena SID terminada en null. Para liberar el búfer devuelto, llame a la función LocalFree .

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. La función GetLastError puede devolver uno de los siguientes códigos de error.

Código devuelto	Descripción
ERROR_NOT_ENOUGH_MEMORY	Memoria insuficiente.
ERROR_INVALID_SID	El SID no es válido.
ERROR_INVALID_PARAMETER	Uno de los parámetros contiene un valor que no es válido. Suele ser un puntero que no es válido.

Comentarios

La función ConvertSidToStringSid usa el S-R-I-S S-estándar... formato para cadenas DE SID. Para obtener más información sobre la notación de cadenas SID, vea Componentes de SID.

Nota

El encabezado sddl.h define ConvertSidToStringSid 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 [aplicaciones de escritorio \| aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2003 [aplicaciones de escritorio \| aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	sddl.h
Library	Advapi32.lib
Archivo DLL	Advapi32.dll