Función NetDfsSetSecurity (lmdfs.h)
Establece el descriptor de seguridad para el objeto raíz del espacio de nombres DFS especificado.
Sintaxis
NET_API_STATUS NET_API_FUNCTION NetDfsSetSecurity(
[in] LPWSTR DfsEntryPath,
[in] SECURITY_INFORMATION SecurityInformation,
[in] PSECURITY_DESCRIPTOR pSecurityDescriptor
);
Parámetros
[in] DfsEntryPath
Puntero a una cadena que especifica la ruta de acceso de convención de nomenclatura universal (UNC) de una raíz del espacio de nombres DFS.
La cadena puede estar en una de las dos formas. El primer formulario es el siguiente:
\\Nombredeservidor\DfsName
donde ServerName es el nombre del servidor de destino raíz que hospeda el espacio de nombres DFS independiente y Dfsname es el nombre del espacio de nombres DFS.
El segundo formulario es el siguiente:
\\Nombrededominio\DomDfsName
donde DomainName es el nombre del dominio que hospeda el espacio de nombres DFS basado en dominio y DomDfsName es el nombre del espacio de nombres DFS.
[in] SecurityInformation
SECURITY_INFORMATION estructura que contiene marcas de bits que indican el tipo de información de seguridad que se va a establecer en el objeto raíz.
[in] pSecurityDescriptor
SECURITY_DESCRIPTOR estructura que contiene el descriptor de seguridad que se va a establecer como se especifica en el parámetro SecurityInformation .
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es NERR_Success.
Si se produce un error en la función, el valor devuelto es un código de error del sistema. Para obtener una lista de códigos de error, consulte Códigos de error del sistema.
Comentarios
En el caso de los espacios de nombres DFS basados en dominio, el descriptor de seguridad se establece en el objeto "CN=DomDfsName,CN=DFS-Configuration,CN=System,DC=domain" de Active Directory en el controlador de dominio principal (PDC) del dominio que hospeda el espacio de nombres DFS, donde <DomDfsName> es el nombre del espacio de nombres DFS basado en dominio y <el dominio> es el nombre distintivo del dominio de Active Directory que hospeda el espacio de nombres.
Para raíces independientes, el descriptor de seguridad se establece en el objeto especificado por la entrada del Registro hkLM\Software\Microsoft\Dfs\Standalone\<root-name> .
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista |
| Servidor mínimo compatible | Windows Server 2008, Windows Server 2008 |
| Plataforma de destino | Windows |
| Encabezado | lmdfs.h (include LmDfs.h, Lm.h) |
| Library | Netapi32.lib |
| Archivo DLL | Netapi32.dll |
Consulte también
Funciones del sistema de archivos distribuido (DFS)