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

Busca una entrada específica en la información de cuota de volumen. El nombre de inicio de sesión de la cuenta del usuario se usa como clave de búsqueda.

Sintaxis

HRESULT FindUserName(
  [in]  LPCWSTR         pszLogonName,
  [out] PDISKQUOTA_USER *ppUser
);

Parámetros

[in] pszLogonName

Puntero al nombre de inicio de sesión de la cuenta del usuario.

[out] ppUser

Puntero al puntero de interfaz IDiskQuotaUser al objeto de usuario de cuota.

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.
ERROR_ACCESS_DENIED	El autor de la llamada tiene derechos de acceso insuficientes.
ERROR_INVALID_SID	El SID del usuario no es válido.
ERROR_NONE_MAPPED	No hay ninguna asignación disponible para el SID.
ERROR_NOT_READY	El objeto DiskQuotaControl no se inicializa.
E_INVALIDARG	El parámetro pUserSid o ppUser es NULL.
E_OUTOFMEMORY	Memoria insuficiente.
E_FAIL	Error inesperado del sistema de archivos.
E_UNEXPECTED	Se produjo una excepción inesperada.

Comentarios

Este método devolverá un objeto de usuario aunque no haya ningún registro de cuota para el usuario en el archivo de cuota. Esto es coherente con la idea de la adición automática de usuarios y la configuración de cuota predeterminada. Si actualmente no hay ninguna entrada de cuota para el usuario solicitado y el usuario se agregaría al archivo de cuota si fuera a solicitar espacio en disco, el objeto de usuario devuelto tendrá umbral de advertencia y límites de cuota máximos iguales a 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