Compartilhar via


Método IDiskQuotaUser::GetName (dskquota.h)

Recupera as cadeias de caracteres de nome associadas a um usuário de cota de disco.

Sintaxe

HRESULT GetName(
  [out] LPWSTR pszAccountContainer,
  [in]  DWORD  cchAccountContainer,
  [out] LPWSTR pszLogonName,
  [in]  DWORD  cchLogonName,
  [out] LPWSTR pszDisplayName,
  [in]  DWORD  cchDisplayName
);

Parâmetros

[out] pszAccountContainer

O nome do contêiner da conta do usuário. Esse valor pode ser NULL. Para contas sem informações de serviço de diretório, essa cadeia de caracteres é simplesmente o nome de domínio. Para contas com informações de serviço de diretório disponíveis, essa cadeia de caracteres é um nome canônico com o nome do objeto de encerramento removido.

[in] cchAccountContainer

O tamanho do buffer de contêiner da conta, em caracteres. Ignorado se pszAccountContainer for NULL.

[out] pszLogonName

Um ponteiro para o buffer para receber o nome especificado pelo usuário para fazer logon no computador. Esse valor pode ser NULL. O formato do nome retornado depende se as informações do serviço de diretório estão disponíveis.

[in] cchLogonName

O tamanho do buffer de nome de logon, em caracteres. Ignorado se pszLogonName for NULL.

[out] pszDisplayName

Um ponteiro para o buffer para receber o nome de exibição do usuário de cota. Esse valor pode ser NULL. Se as informações não estiverem disponíveis, a cadeia de caracteres retornada será de comprimento zero.

[in] cchDisplayName

O tamanho do buffer de nome de exibição, em caracteres. Ignorado se pszDisplayName for NULL.

Valor retornado

Esse método retorna um dos valores a seguir.

Código de retorno Descrição
S_OK
Êxito.
ERROR_LOCK_FAILED
Falha ao obter um bloqueio exclusivo.

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

Confira também

Interfaces do gerenciamento de disco

Cotas de disco

IDiskQuotaUser