Método IDiskQuotaControl::CreateEnumUsers (dskquota.h)
Crea un objeto enumerador para enumerar usuarios de cuota en el volumen. El objeto recién creado implementa la interfaz IEnumDiskQuotaUsers .
Sintaxis
HRESULT CreateEnumUsers(
[in] PSID *rgpUserSids,
[in] DWORD cpSids,
[in] DWORD fNameResolution,
[out] PENUM_DISKQUOTA_USERS *ppEnum
);
Parámetros
[in] rgpUserSids
Matriz de punteros de identificador de seguridad (SID) que representan los objetos de usuario que se van a incluir en la enumeración. Si este valor es NULL, se enumeran todas las entradas de usuario.
[in] cpSids
Número de elementos de la matriz rgpUserSids . Se omite si rgpUserSids es NULL.
[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 |
|---|---|
|
Resuelva la información de la cuenta de usuario de forma asincrónica. El método IEnumDiskQuotaUsers::Next 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. |
|
No resuelva la información de la cuenta de usuario. |
|
Resuelva la información de la cuenta de usuario de forma sincrónica. El método IEnumDiskQuotaUsers::Next 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] ppEnum
Puntero a un puntero al enumerador IEnumDiskQuotaUsers .
Valor devuelto
Este método devuelve uno de los valores siguientes.
| Código devuelto | Descripción |
|---|---|
|
Correcto. |
|
El autor de la llamada tiene derechos de acceso insuficientes. |
|
El objeto DiskQuotaControl no se inicializa. |
|
El parámetro ppEnum es NULL. |
|
Memoria insuficiente. |
|
Se produjo una excepción inesperada. |
Requisitos
| Requisito | Value |
|---|---|
| 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 |