Método IDiskQuotaControl::AddUserName (dskquota.h)

Agrega una nueva entrada de cuota en el volumen para el usuario especificado. El usuario se identifica por dominio y nombre de cuenta.

Sintaxis

HRESULT AddUserName(
  [in]  LPCWSTR         pszLogonName,
  [in]  DWORD           fNameResolution,
  [out] PDISKQUOTA_USER *ppUser
);

Parámetros

[in] pszLogonName

Cadena de nombre de inicio de sesión de cuenta del usuario.

[in] fNameResolution

Indica cómo se va a obtener la información de la cuenta de usuario. La información de cuota del volumen identifica a los usuarios por SID. La información de la cuenta de usuario (como el contenedor, el nombre de inicio de sesión y el nombre para mostrar) debe obtenerse del controlador de dominio de red o del equipo local si no está en una red. Este parámetro puede ser uno de los valores siguientes.

Valor	Significado
DISKQUOTA_USERNAME_RESOLVE_ASYNC 2	Resuelva la información de la cuenta de usuario de forma asincrónica. AddUserName devuelve inmediatamente. El autor de la llamada debe implementar la interfaz IDiskQuotaEvents para recibir una notificación cuando la información esté disponible. Si la información se almacena en caché durante una solicitud anterior, la notificación se produce en cuanto se realiza el servicio del objeto. De lo contrario, el método obtiene la información del controlador de dominio de red y, a continuación, notifica a IDiskQuotaEvents.
DISKQUOTA_USERNAME_RESOLVE_NONE 0	No resuelva la información de la cuenta de usuario.
DISKQUOTA_USERNAME_RESOLVE_SYNC 1	Resuelva la información de la cuenta de usuario de forma sincrónica. AddUserName devuelve cuando se resuelve la información. Si la información existe en la memoria caché del SID de cuota de disco, se devuelve inmediatamente. De lo contrario, el método debe buscar la información. Esto puede tardar varios segundos.

[out] ppUser

Puntero al puntero de interfaz IDiskQuotaUser al objeto de usuario de cuota recién creado.

Valor devuelto

Este método devuelve un error del sistema de archivos o uno de los valores siguientes.

Código devuelto	Descripción
S_OK	Correcto.
S_FALSE	El usuario ya existe. No se ha agregado.
ERROR_NOT_READY	El objeto DiskQuotaControl no se inicializa.
ERROR_USER_UNKNOWN	El nombre de usuario especificado es desconocido.
E_INVALIDARG	Un parámetro de puntero es NULL.
E_OUTOFMEMORY	Memoria insuficiente.
E_FAIL	Error inesperado del sistema de archivos.
E_UNEXPECTED	Se produjo una excepción inesperada.

Comentarios

El sistema de archivos NTFS crea automáticamente una entrada de cuota de usuario la primera vez que un usuario escribe en el volumen. A las entradas que se crean automáticamente se les asignan los valores predeterminados de umbral de advertencia y límite de cuota máxima para el volumen. Este método permite crear una entrada de cuota de usuario antes de que un usuario haya escrito información en el volumen. Por lo tanto, puede asignar previamente un umbral de advertencia o un valor de límite de cuota duro diferente de la configuración predeterminada del volumen.

Requisitos

Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	dskquota.h
Archivo DLL	Dskquota.dll

Consulte también

Interfaces de administración de discos

Cuotas de disco

IDiskQuotaControl