estructura DFS_STORAGE_INFO (lmdfs.h)

Artículo
03/14/2023

Contiene información sobre un destino raíz o de vínculo DFS en un espacio de nombres DFS o desde la memoria caché mantenida por el cliente DFS. La información sobre un destino raíz o de vínculo DFS en un espacio de nombres DFS se recupera mediante una llamada a la función NetDfsGetInfo . La información sobre un destino raíz o de vínculo DFS de la memoria caché mantenida por el cliente DFS se recupera mediante una llamada a la función NetDfsGetClientInfo .

Sintaxis

typedef struct _DFS_STORAGE_INFO {
  ULONG  State;
  LPWSTR ServerName;
  LPWSTR ShareName;
} DFS_STORAGE_INFO, *PDFS_STORAGE_INFO, *LPDFS_STORAGE_INFO;

Members

State

Estado del destino.

Cuando esta estructura se devuelve como resultado de llamar a la función NetDfsGetInfo , este miembro puede ser uno de los valores siguientes.

DFS_STORAGE_STATE_OFFLINE (0x00000001)

El destino raíz o vínculo DFS está sin conexión.

DFS_STORAGE_STATE_ONLINE (0x00000002)

El destino raíz o vínculo DFS está en línea.

Cuando esta estructura se devuelve como resultado de llamar a la función NetDfsGetClientInfo , el estado DFS_STORAGE_STATE_ONLINE (0x00000002) se establece de forma predeterminada. Si el destino es el destino activo en la memoria caché del cliente DFS, el siguiente valor se combina lógicamente con el valor predeterminado a través del operador OR .

DFS_STORAGE_STATE_ACTIVE (0x00000004)

El destino raíz o vínculo DFS es el destino activo.

ServerName

Puntero a una cadena Unicode terminada en null que especifica el destino raíz DFS o el nombre del servidor de destino de vínculo.

ShareName

Puntero a una cadena Unicode terminada en null que especifica el destino raíz DFS o el nombre del recurso compartido de destino de vínculo.

Comentarios

Las estructuras DFS_INFO_3 y DFS_INFO_4 contienen una o varias estructuras de DFS_STORAGE_INFO , una para cada destino DFS. Solo se puede marcar un destino como destino activo. Es posible que no haya destinos marcados como activos.