Função NPGetResourceParent (npapi.h)

Artigo
08/25/2023

Recupera o pai de um recurso de rede especificado na hierarquia de navegação. Essa função normalmente é chamada para recursos que foram retornados pelo mesmo provedor de chamadas anteriores para NPEnumResource ou NPGetResourceInformation.

Sintaxe

DWORD NPGetResourceParent(
  [in]      LPNETRESOURCEW lpNetResource,
  [out]     LPVOID         lpBuffer,
  [in, out] LPDWORD        lpBufferSize
);

Parâmetros

[in] lpNetResource

Ponteiro para o recurso de rede cujo nome pai é necessário. O NETRESOURCE poderia ter sido obtido de uma chamada anterior para NPEnumResource ou NPGetResourceInformation ou construído pelo chamador.

O campo lpRemoteName especifica o nome remoto do recurso de rede cujo pai é necessário.

O campo lpProvider especifica o provedor a ser chamado. Isso deve ser fornecido.

O campo dwType será preenchido se o programa de chamada souber seu valor. Caso contrário, ele será definido como NULL.

Todos os outros campos no NETRESOURCE são ignorados e não são inicializados.

[out] lpBuffer

Ponteiro para um buffer para receber o resultado, que é uma única estrutura NETRESOURCE que representa o recurso pai. Os campos lpRemoteName, lpProvider, dwType, dwDisplayType e dwUsage são retornados ; todos os outros campos são definidos como NULL.

O lpRemoteName de saída deve estar no mesmo formato que o retornado de uma enumeração por NPEnumResource, para que o chamador possa executar uma comparação de cadeia de caracteres que diferencia maiúsculas de minúsculas para determinar se o recurso pai é o mesmo retornado por NPEnumResource. Se o recurso de entrada tiver sintaticamente um pai, o provedor poderá retorná-lo, sem determinar se o recurso de entrada ou seu pai realmente existem. Se um recurso não tiver nenhum pai de navegação na rede, lpRemoteName será retornado como NULL.

O bit RESOURCEUSAGE_CONNECTABLE no campo dwUsage retornado não indica necessariamente que o recurso pode ser conectado no momento, apenas que o recurso é conectável quando está disponível na rede.

[in, out] lpBufferSize

Ponteiro para um local que especifica o tamanho, em bytes, do buffer apontado pelo parâmetro lpBuffer . Se o buffer for muito pequeno para o resultado, a função colocará o tamanho do buffer necessário neste local e retornará o erro WN_MORE_DATA.

Retornar valor

Se a função for bem-sucedida, ela deverá retornar WN_SUCCESS. Caso contrário, ele deverá retornar um código de erro, que pode ser um dos seguintes.

Código de retorno	Descrição
WN_MORE_DATA	O buffer de entrada é muito pequeno.
WN_BAD_NETNAME	Esse provedor não possui o recurso especificado por lpNetResource (ou o recurso não é sintaticamente válido).
WN_BAD_VALUE	DwUsage ou dwType não é válido ou há uma combinação incorreta de parâmetros especificados (por exemplo, lpRemoteName é sintaticamente inválido para dwType).
WN_NOT_AUTHENTICATED	O chamador não foi autenticado na rede.
WN_ACCESS_DENIED	O chamador foi autenticado na rede, mas não tem permissões suficientes.

Requisitos

Requisito	Valor
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	npapi.h