Função WNetGetResourceParentA (winnetwk.h)

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. 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 de 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 poderá 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 o lpRemoteName, lpProvider, dwType, dwDisplayTypee dwUsage membros 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 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.

Valor de retorno

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	A entrada lpRemoteName membro não é um recurso de rede existente para nenhuma rede.
ERROR_BAD_PROVIDER	A entrada lpProvider membro 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.

Observações

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. WNetGetResourceParent normalmente deve ser usado apenas por aplicativos que exibem recursos de rede para o usuário de forma 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, WNetGetResourceInformationou 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 um 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 em que os domínios aparecem diretamente acima dos servidores na hierarquia de navegação. A função retornará resultados incorretos para outras redes.

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	winnetwk.h
biblioteca	Mpr.lib
de DLL	Mpr.dll

Consulte também

WNetGetNetworkInformation

WNetGetProviderName

WNetGetResourceInformation

WNetGetUniversalName

Visão geral WNet (Rede windows)

funções de rede do Windows