Función ConvertSidToStringSidA (sddl.h)
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 del 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 |
|---|---|
|
Memoria insuficiente. |
|
El SID no es válido. |
|
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 estándar S-R-I-S S-... 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 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
| 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 |
Consulte también
Información general del control de acceso
Funciones básicas de Access Control
ConvertSecurityDescriptorToStringSecurityDescriptor