Função NPGetUniversalName (npapi.h)

  • Artigo

Recupera o nome universal de um recurso de rede. A função NPGetUniversalName pode recuperar esse nome universal no formato UNC ou no formato de nome remoto mais antigo.

Sintaxe

DWORD NPGetUniversalName(
  [in]      LPCWSTR lpLocalPath,
  [in]      DWORD   dwInfoLevel,
  [out]     LPVOID  lpBuffer,
  [in, out] LPDWORD lpBufferSize
);

Parâmetros

[in] lpLocalPath

Ponteiro para o caminho local de um objeto em um recurso de rede. Esse é um caminho baseado em unidade.

[in] dwInfoLevel

O nível de detalhes das informações em que o chamador está interessado. Esse pode ser um dos valores a seguir.

Valor Significado
UNIVERSAL_NAME_INFO_LEVEL
 Recupera a forma UNC do nome, por exemplo: "file:\\server\share"

Se esse valor for definido, os dados retornados no lpBuffer serão armazenados como uma estrutura UNIVERSAL_NAME_INFO .
REMOTE_NAME_INFO_LEVEL
 Recupera a forma remota do nome, por exemplo: "\\server\share"

Se esse valor for definido, os dados retornados no lpBuffer serão armazenados como uma estrutura REMOTE_NAME_INFO .

[out] lpBuffer

Ponteiro para um buffer para receber as informações solicitadas pelo usuário. A estrutura específica retornada depende do nível de informações especificado em dwInfoLevel.

[in, out] lpBufferSize

Ponteiro para o tamanho, em bytes, do buffer lpBuffer . Se a chamada falhar porque o buffer não é grande o suficiente, esse local será usado para retornar o tamanho do buffer necessário.

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_BAD_LOCALNAME
 O valor passado para lpLocalPath não é válido.
WN_NOT_CONNECTED
 O valor passado para lpLocalPath não é um dispositivo redirecionado.
WN_MORE_DATA
 O buffer é muito pequeno.
WN_NO_NETWORK
 A rede não está presente.

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