Função WNetGetResourceParentA (winnetwk.h)

Artigo
03/08/2023

A função WNetGetResourceParent retorna o pai de um recurso de rede na hierarquia de navegação de rede. A navegação começa no local do recurso de rede especificado.

Chame as funções WNetGetResourceInformation e WNetGetResourceParent para mover a hierarquia de rede para cima. Chame a função WNetOpenEnum para mover para baixo na hierarquia.

Sintaxe

DWORD WNetGetResourceParentA(
  [in]      LPNETRESOURCEA lpNetResource,
  [out]     LPVOID         lpBuffer,
  [in, out] LPDWORD        lpcbBuffer
);

Parâmetros

[in] lpNetResource

Ponteiro para uma estrutura NETRESOURCE que especifica o recurso de rede para o qual o nome pai é necessário.

Especifique os membros da estrutura NETRESOURCE de entrada da seguinte maneira. O chamador normalmente conhece os valores a serem fornecidos para os membros lpProvider e dwType após chamadas anteriores para WNetGetResourceInformation ou WNetGetResourceParent.

Membro	Significado
Dwtype	Esse membro deve ser preenchido, se conhecido; caso contrário, ele deve ser definido como NULL.
Lpremotename	Esse membro deve especificar o nome remoto do recurso de rede cujo pai é necessário.
lpProvider	Esse membro deve especificar o provedor de rede que possui o recurso. Esse membro é necessário; caso contrário, a função poderia produzir resultados incorretos.

Todos os outros membros da estrutura NETRESOURCE são ignorados.

[out] lpBuffer

Ponteiro para um buffer para receber uma única estrutura NETRESOURCE que representa o recurso pai. A função retorna os membros lpRemoteName, lpProvider, dwType, dwDisplayType e dwUsage da estrutura; todos os outros membros são definidos como NULL.

O membro lpRemoteName aponta para o nome remoto do recurso pai. Esse nome usa a mesma sintaxe que a retornada de uma enumeração pela função WNetEnumResource . O chamador pode executar uma comparação de cadeia de caracteres para determinar se o recurso WNetGetResourceParent é o mesmo retornado por WNetEnumResource. Se o recurso de entrada não tiver nenhum pai em nenhuma das redes, o membro lpRemoteName será retornado como NULL.

A presença do bit RESOURCEUSAGE_CONNECTABLE no membro dwUsage indica que você pode se conectar ao recurso pai, mas somente quando ele estiver disponível na rede.

[in, out] lpcbBuffer

Ponteiro para um local que, na entrada, especifica o tamanho do buffer lpBuffer , em bytes. Se o buffer for muito pequeno para conter o resultado, esse local receberá o tamanho do buffer necessário e a função retornará ERROR_MORE_DATA.

Retornar valor

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

Se a função falhar, o valor retornado será um código de erro do sistema, como um dos valores a seguir.

Código de retorno	Descrição
ERROR_ACCESS_DENIED	O chamador não tem acesso ao recurso de rede.
ERROR_BAD_NET_NAME	O membro lpRemoteName de entrada não é um recurso de rede existente para nenhuma rede.
ERROR_BAD_PROVIDER	O membro lpProvider de entrada não corresponde a nenhum provedor de rede instalado.
ERROR_MORE_DATA	O buffer apontado pelo parâmetro lpBuffer é muito pequeno.
ERROR_NOT_AUTHENTICATED	O chamador não tem as permissões necessárias para obter o nome do pai.

Comentários

A função WNetGetResourceParent normalmente é usada em conjunto com a função WNetGetResourceInformation para analisar e interpretar um caminho de rede digitado por um usuário.

Ao contrário da função WNetGetResourceInformation , se o recurso incluir um pai em sua sintaxe, a função WNetGetResourceParent retornará o pai, independentemente de o recurso existir ou não. O WNetGetResourceParent normalmente deve ser usado apenas por aplicativos que exibem recursos de rede para o usuário de maneira hierárquica. O Windows Explorer e a caixa de diálogo Abrir Arquivo são dois exemplos conhecidos desse tipo de aplicativo. Observe que nenhuma suposição deve ser feita sobre o tipo de recurso que será retornado.

Você pode chamar a função WNetEnumResource, WNetGetResourceInformation ou WNetGetResourceParent para retornar informações da estrutura NETRESOURCE . Você também pode construir informações de recurso de rede usando os membros da estrutura NETRESOURCE .

Um exemplo de uso inadequado de WNetGetResourceParent é determinar o nome do domínio ao qual pertence um servidor especificado. A função pode retornar o nome de domínio correto para algumas redes nas quais os domínios aparecem diretamente acima dos servidores na hierarquia de navegação. A função retornará resultados incorretos para outras redes.

Observação

O cabeçalho winnetwk.h define WNetGetResourceParent como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

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	winnetwk.h
Biblioteca	Mpr.lib
DLL	Mpr.dll