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

  • Artículo

Busca una entrada de usuario específica en la información de cuota de volumen. El identificador de seguridad (SID) del usuario se usa como clave de búsqueda.

Sintaxis

HRESULT FindUserSid(
  [in]  PSID            pUserSid,
  [in]  DWORD           fNameResolution,
  [out] PDISKQUOTA_USER *ppUser
);

Parámetros

[in] pUserSid

Puntero al SID 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 nombre de dominio, el nombre de cuenta y el nombre completo) se debe obtener 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. FindUserSid 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. FindUserSid devuelve cuando se ha resuelto 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 para recibir el 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_NOT_READY
 El objeto DiskQuotaControl no se inicializa.
ERROR_INVALID_SID
 El SID del usuario no es válido.
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 incluso si no hay 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á límites de advertencia y cuota máxima igual 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