Compartir a través de

Función NetDfsGetSecurity (lmdfs.h)

  • Artículo

Recupera el descriptor de seguridad para el objeto raíz del espacio de nombres DFS especificado.

Sintaxis

NET_API_STATUS NET_API_FUNCTION NetDfsGetSecurity(
  [in]  LPWSTR               DfsEntryPath,
  [in]  SECURITY_INFORMATION SecurityInformation,
  [out] PSECURITY_DESCRIPTOR *ppSecurityDescriptor,
  [out] LPDWORD              lpcbSecurityDescriptor
);

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 recuperar del objeto raíz.

[out] ppSecurityDescriptor

Puntero a una lista de SECURITY_DESCRIPTOR estructuras que contienen los elementos de seguridad solicitados en el parámetro SecurityInformation .

Nota Este búfer debe liberarse llamando a la función NetApiBufferFree .
 

[out] lpcbSecurityDescriptor

Tamaño del búfer al que apunta ppSecurityDescriptor , en bytes.

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 recupera del objeto "CN=DomDfsName,CN=DFS-Configuration,CN=System,DC=domain" de Active Directory desde 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 recupera del 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)

NetDfsSetSecurity

Funciones de administración de redes

Introducción a la administración de redes