Método IDiskQuotaControl::FindUserSid (dskquota.h)
Localiza uma entrada de usuário específica nas informações de cota de volume. O SID (identificador de segurança) do usuário é usado como a chave de pesquisa.
Sintaxe
HRESULT FindUserSid(
[in] PSID pUserSid,
[in] DWORD fNameResolution,
[out] PDISKQUOTA_USER *ppUser
);
Parâmetros
[in] pUserSid
Um ponteiro para o SID do usuário.
[in] fNameResolution
Indica como as informações da conta de usuário devem ser obtidas. As informações de cota do volume identificam os usuários por SID. As informações da conta de usuário (como nome de domínio, nome da conta e nome completo) devem ser obtidas do controlador de domínio de rede ou do computador local se não estiver em uma rede. Esse parâmetro pode usar um dos valores a seguir.
| Valor | Significado |
|---|---|
|
Resolva as informações da conta de usuário de forma assíncrona. FindUserSid retorna imediatamente. O chamador deve implementar a interface IDiskQuotaEvents para receber notificação quando as informações estiverem disponíveis. Se as informações tiverem sido armazenadas em cache durante uma solicitação anterior, a notificação ocorrerá assim que o objeto for atendido. Caso contrário, o método obtém as informações do controlador de domínio de rede e notifica IDiskQuotaEvents. |
|
Não resolve informações da conta de usuário. |
|
Resolva as informações da conta de usuário de forma síncrona. FindUserSid retorna quando as informações são resolvidas. Se as informações existirem no cache de SID de cota de disco, elas serão retornadas imediatamente. Caso contrário, o método deve localizar as informações. Isso pode levar vários minutos. |
[out] ppUser
Ponteiro para receber o ponteiro da interface IDiskQuotaUser para o objeto de usuário de cota.
Valor retornado
Esse método retorna um erro do sistema de arquivos ou um dos valores a seguir.
| Código de retorno | Descrição |
|---|---|
|
Êxito. |
|
O chamador não tem direitos de acesso suficientes. |
|
O objeto DiskQuotaControl não é inicializado. |
|
O SID do usuário é inválido. |
|
O parâmetro pUserSid ou ppUser é NULL. |
|
Memória insuficiente. |
|
Ocorreu um erro inesperado do sistema de arquivos. |
|
Ocorreu uma exceção inesperada. |
Comentários
Esse método retornará um objeto de usuário mesmo que não haja registro de cota para o usuário no arquivo de cota. Isso é consistente com a ideia de adição automática de usuário e configurações de cota padrão. Se atualmente não houver nenhuma entrada de cota para o usuário solicitado e o usuário for adicionado ao arquivo de cota se ele solicitar espaço em disco, o objeto de usuário retornado terá limite de aviso e limites de cota rígidos iguais às configurações padrão do volume.
Requisitos
| Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | dskquota.h |
| DLL | Dskquota.dll |