Determinando a localização de um compartilhamento

O exemplo a seguir demonstra como chamar a função WNetGetUniversalName para determinar o local de um compartilhamento em uma unidade redirecionada.

Primeiro, o exemplo de código chama a função WNetGetUniversalName , especificando o nível de informações UNIVERSAL_NAME_INFO para recuperar um ponteiro para uma cadeia de caracteres de nome UNC (Convenção Universal de Nomenclatura) para o recurso. Em seguida, o exemplo chama WNetGetUniversalName uma segunda vez, especificando o nível de informações REMOTE_NAME_INFO para recuperar duas cadeias de caracteres de informações de conexão de rede adicionais. Se as chamadas forem bem-sucedidas, o exemplo imprimirá o local do compartilhamento.

Para testar o seguinte exemplo de código, execute as seguintes etapas:

1. Nomeie o exemplo de código GetUni.cpp.

2. Adicione o exemplo a um aplicativo de console chamado GetUni.

3. Vincule as bibliotecas Shell32.lib, Mpr.lib e NetApi32.lib à lista de bibliotecas do compilador.

4. No prompt de comando, altere para o diretório GetUni.

5. Compile GetUni.cpp.

6. Execute o arquivo GetUni.exe seguido por uma letra da unidade e dois-pontos, desta forma:

   GetUni H:\

#define  STRICT
#include <windows.h>
#include <tchar.h>
#include <stdio.h>

#pragma comment(lib, "mpr.lib")

#define BUFFSIZE = 1000

void main( int argc, char *argv[] )
{
  DWORD cbBuff = 1000;    // Size of Buffer
  TCHAR szBuff[1000];    // Buffer to receive information
  REMOTE_NAME_INFO  * prni = (REMOTE_NAME_INFO *)   &szBuff;
  UNIVERSAL_NAME_INFO * puni = (UNIVERSAL_NAME_INFO *) &szBuff;
  DWORD res;

  if((argc < 2) | (lstrcmp(argv[1], "/?") == 0))
  {
    printf("Syntax:  GetUni DrivePathAndFilename\n"
         "Example: GetUni U:\\WINNT\\SYSTEM32\\WSOCK32.DLL\n");
    return;
  }
  
  // Call WNetGetUniversalName with the UNIVERSAL_NAME_INFO_LEVEL option
  //
  printf("Call WNetGetUniversalName using UNIVERSAL_NAME_INFO_LEVEL.\n");
  if((res = WNetGetUniversalName((LPTSTR)argv[1],
         UNIVERSAL_NAME_INFO_LEVEL, // The structure is written to this block of memory. 
         (LPVOID) &szBuff, 
         &cbBuff)) != NO_ERROR) 
    //
    // If the call fails, print the error; otherwise, print the location of the share, 
    //  using the pointer to UNIVERSAL_NAME_INFO_LEVEL.
    //
    printf("Error: %ld\n\n", res); 
   
  else
    _tprintf(TEXT("Universal Name: \t%s\n\n"), puni->lpUniversalName); 
    
  //
  // Call WNetGetUniversalName with the REMOTE_NAME_INFO_LEVEL option
  //
  printf("Call WNetGetUniversalName using REMOTE_NAME_INFO_LEVEL.\n");
  if((res = WNetGetUniversalName((LPTSTR)argv[1], 
         REMOTE_NAME_INFO_LEVEL, 
         (LPVOID) &szBuff,    //Structure is written to this block of memory
         &cbBuff)) != NO_ERROR) 
    //
    // If the call fails, print the error; otherwise, print
    //  the location of the share, using 
    //  the pointer to REMOTE_NAME_INFO_LEVEL.
    //
    printf("Error: %ld\n", res); 
  else
    _tprintf(TEXT("Universal Name: \t%s\nConnection Name:\t%s\nRemaining Path: \t%s\n"),
          prni->lpUniversalName, 
          prni->lpConnectionName, 
          prni->lpRemainingPath);
  return;
}