Función MakeSelfRelativeSD (securitybaseapi.h)
La función MakeSelfRelativeSD crea un descriptor de seguridad en formato relativo propio mediante un descriptor de seguridad en formato absoluto como plantilla.
Sintaxis
BOOL MakeSelfRelativeSD(
[in] PSECURITY_DESCRIPTOR pAbsoluteSecurityDescriptor,
[out, optional] PSECURITY_DESCRIPTOR pSelfRelativeSecurityDescriptor,
[in, out] LPDWORD lpdwBufferLength
);
Parámetros
[in] pAbsoluteSecurityDescriptor
Puntero a una estructura de SECURITY_DESCRIPTOR en formato absoluto. La función crea una versión de este descriptor de seguridad en formato relativo propio sin modificar el original.
[out, optional] pSelfRelativeSecurityDescriptor
Puntero a un búfer que la función rellena con un descriptor de seguridad en formato relativo propio.
[in, out] lpdwBufferLength
Puntero a una variable que especifica el tamaño del búfer al que apunta el parámetro pSelfRelativeSD . Si el búfer no es lo suficientemente grande para el descriptor de seguridad, se produce un error en la función y establece esta variable en el tamaño mínimo necesario.
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. Entre los códigos de retorno posibles se incluyen, entre otros, los siguientes.
| Código o valor devuelto | Descripción |
|---|---|
|
Uno o varios de los búferes son demasiado pequeños. |
Comentarios
Un descriptor de seguridad en formato absoluto contiene punteros a la información que contiene, en lugar de contener la propia información. Un descriptor de seguridad en formato autorrelativo contiene la información en un bloque contiguo de memoria. En un descriptor de seguridad relativo a sí mismo, una estructura de SECURITY_DESCRIPTOR siempre inicia la información, pero los demás componentes del descriptor de seguridad pueden seguir la estructura en cualquier orden. En lugar de usar direcciones de memoria, los componentes del descriptor de seguridad se identifican mediante desplazamientos desde el principio del descriptor de seguridad. Este formato es útil cuando un descriptor de seguridad debe almacenarse en un disco de disquete o transmitirse mediante un protocolo de comunicaciones.
Un servidor que copia objetos protegidos en varios medios puede usar la función MakeSelfRelativeSD para crear un descriptor de seguridad auto relativo a partir de un descriptor de seguridad absoluto y la función MakeAbsoluteSD para crear un descriptor de seguridad absoluto a partir de un descriptor de seguridad auto relativo.
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 | securitybaseapi.h (incluya Windows.h) |
| Library | Advapi32.lib |
| Archivo DLL | Advapi32.dll |