Función ConvertSidToStringSidA (sddl.h)

Artículo
11/20/2024

La función ConvertSidToStringSid convierte un identificador de seguridad de (SID) en un formato de cadena adecuado para la visualización, el almacenamiento o la transmisión.

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 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 ejecuta correctamente, el valor devuelto es distinto de cero.

Si se produce un error en la función, 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.

Observaciones

La función ConvertSidToStringSid usa el estándar S-RISS... formato para cadenas 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 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 [aplicaciones de escritorio \| Aplicaciones para UWP]
servidor mínimo admitido	Windows Server 2003 [aplicaciones de escritorio \| Aplicaciones para UWP]
de la plataforma de destino de	Windows
encabezado de	sddl.h
biblioteca de	Advapi32.lib
DLL de	Advapi32.dll