Função NetGetDisplayInformationIndex (lmaccess.h)

A função NetGetDisplayInformationIndex retorna o índice da primeira entrada de informações de exibição cujo nome começa com uma cadeia de caracteres especificada ou cujo nome segue alfabeticamente a cadeia de caracteres. Você pode usar essa função para determinar um índice inicial para chamadas subsequentes para a função NetQueryDisplayInformation .

Sintaxe

NET_API_STATUS NET_API_FUNCTION NetGetDisplayInformationIndex(
  [in]  LPCWSTR ServerName,
  [in]  DWORD   Level,
  [in]  LPCWSTR Prefix,
  [out] LPDWORD Index
);

Parâmetros

[in] ServerName

Ponteiro para uma cadeia de caracteres constante que especifica o nome DNS ou NetBIOS do servidor remoto no qual a função deve ser executada. Se esse parâmetro for NULL, o computador local será usado.

[in] Level

Especifica o nível de contas a serem consultadas. Esse parâmetro pode usar um dos valores a seguir.

Valor	Significado
1	Consulte todas as contas de usuário locais e globais (normais).
2	Consultar todas as contas de usuário da estação de trabalho e do servidor.
3	Consultar todos os grupos globais.

[in] Prefix

Ponteiro para uma cadeia de caracteres que especifica o prefixo para o qual pesquisar.

[out] Index

Ponteiro para um valor que recebe o índice da entrada solicitada.

Valor retornado

Se a função for bem-sucedida, o valor retornado será NERR_Success.

Se a função falhar, o valor retornado poderá ser um dos códigos de erro a seguir.

Código de retorno	Descrição
ERROR_ACCESS_DENIED	O usuário não tem acesso às informações solicitadas.
ERROR_INVALID_LEVEL	O valor especificado para o parâmetro Level é inválido.
ERROR_NO_MORE_ITEMS	Não havia mais itens nos quais operar.
NERR_InvalidComputer	O nome do computador é inválido.

Comentários

Se você chamar essa função em um controlador de domínio que está executando o Active Directory, o acesso será permitido ou negado com base na ACL (lista de controle de acesso) do objeto protegível. A ACL padrão permite que todos os usuários autenticados e membros do grupo "Acesso compatível com o Pré-Windows 2000" exibam as informações. Se você chamar essa função em um servidor membro ou estação de trabalho, todos os usuários autenticados poderão exibir as informações. Para obter informações sobre acesso anônimo e restringir o acesso anônimo nessas plataformas, consulte Requisitos de segurança para as funções de gerenciamento de rede. Para obter mais informações sobre ACLs, ACEs e tokens de acesso, consulte Controle de Acesso Model.

A função retorna apenas informações para as quais o chamador tem acesso de Leitura. O chamador deve ter acesso de Conteúdo de Lista ao objeto Domain e enumerar todo o acesso ao domínio SAM no objeto servidor SAM localizado no contêiner Do sistema.

Requisitos

Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	lmaccess.h (inclua Lm.h)
Biblioteca	Netapi32.lib
DLL	Netapi32.dll

Confira também

Obter funções

NetQueryDisplayInformation

Funções de gerenciamento de rede

Visão geral do gerenciamento de rede