Função NetAccessEnum (lmaccess.h)

[Essa função está obsoleta. Para obter uma lista de funções alternativas, consulte Funções de autorização.]

Não há suporte.

A função NetAccessEnum recupera informações sobre cada registro de permissão de acesso.

Sintaxe

NET_API_STATUS NET_API_FUNCTION NetAccessEnum(
  LPCWSTR servername,
  LPCWSTR BasePath,
  DWORD   Recursive,
  DWORD   level,
  LPBYTE  *bufptr,
  DWORD   prefmaxlen,
  LPDWORD entriesread,
  LPDWORD totalentries,
  LPDWORD resume_handle
);

Parâmetros

servername

Ponteiro para uma cadeia de caracteres 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.

BasePath

Ponteiro para uma cadeia de caracteres que contém um nome de caminho base para o recurso. Um ponteiro NULL ou uma cadeia de caracteres NULL significa que nenhum caminho base deve ser usado. O caminho pode ser especificado como um nome de caminho UNC (convenção de nomenclatura universal).

Recursive

Especifica um sinalizador que habilita ou desabilita a pesquisa recursiva.

Se esse parâmetro for igual a zero, a função NetAccessEnum retornará entradas para o recurso nomeado como o caminho base pelo parâmetro pszBasePath e para os recursos diretamente abaixo desse caminho base.

Se esse parâmetro for diferente de zero, a função retornará entradas para todas as ACLs (listas de controle de acesso) que têm pszBasePath no início do nome do recurso.

level

Especifica o nível de informações dos dados. Esse parâmetro pode usar um dos valores a seguir.

Valor	Significado
0	O parâmetro pbBuffer aponta para uma estrutura access_info_0 .
1	O parâmetro pbBuffer aponta para uma estrutura access_info_1 .

bufptr

Ponteiro para o buffer que recebe a estrutura de informações de acesso. O formato desses dados depende do valor do parâmetro sLevel .

prefmaxlen

Especifica o tamanho, em bytes, do buffer apontado pelo parâmetro pbBuffer .

entriesread

Ponteiro para um inteiro curto sem sinal que recebe a contagem de elementos realmente enumerados. A contagem será válida somente se a função NetAccessEnum retornar NERR_Success ou ERROR_MORE_DATA.

totalentries

Ponteiro para um inteiro curto sem sinal que recebe o número total de entradas que poderiam ter sido enumeradas. A contagem será válida somente se a função NetAccessEnum retornar NERR_Success ou ERROR_MORE_DATA.

resume_handle

TBD

Retornar valor

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

Se a função falhar, o valor retornado será um código de erro do sistema. Para obter uma lista de códigos de erro, consulte Códigos de erro do sistema.

Comentários

Essa função requer Administração privilégio para ser executada com êxito em um computador que tenha a segurança local habilitada.

Requisitos

Requisito	Valor
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, Lmaccess.h)
Biblioteca	Netapi32.lib
DLL	Netapi32.dll

Confira também

Funções de autorização