_searchenv, _wsearchenv

Artigo
03/12/2013

Usa caminhos de ambiente para procurar por um arquivo.Versões mais seguros dessas funções estão disponíveis; consulte _searchenv_s, _wsearchenv_s.

Importante
Este API não pode ser usado em aplicativos executados em Tempo de Execução do Windows.Para obter mais informações, consulte Funções de CRT não suportadas com /ZW.

void _searchenv( const char *filename, const char *varname, char *pathname ); void _wsearchenv( const wchar_t *filename, const wchar_t *varname, wchar_t *pathname ); template <size_t size> void _searchenv( const char *filename, const char *varname, char (&pathname)[size] ); // C++ only template <size_t size> void _wsearchenv( const wchar_t *filename, const wchar_t *varname, wchar_t (&pathname)[size] ); // C++ only

Parâmetros

filename
Nome do arquivo para procurar por.
varname
Ambiente a pesquisa.
pathname
Buffer para armazenar o caminho completo.

Comentários

Pesquisas rotineiras de _searchenv para o arquivo de destino no domínio especificado.A variável de varname pode ser qualquer ambiente ou definido pelo usuário variável para o exemplo, o PATH, o LIB, ou o INCLUDE— especifica uma lista de caminhos de diretório.Porque _searchenv diferencia maiúsculas de minúsculas, varname deve coincidir com os exemplos da variável de ambiente.

O primeiro rotineiro procura por arquivo no diretório de trabalho corrente.Se não encontra o arquivo, procurará através de pastas que são especificados pela variável de ambiente.Se o arquivo de destino está em um desses diretórios, o caminho recém-criado é copiado para pathname.Se o arquivo de filename não for encontrado, pathname contém uma cadeia de caracteres vazia NULL- finalizada.

O buffer de pathname deve ser pelo menos caracteres de _MAX_PATH long para acomodar o comprimento total do nome do caminho construído.Caso contrário, _searchenv pode passar o buffer de pathname e causar um comportamento inesperado.

_wsearchenv é uma versão de largo- caractere de _searchenv, e os argumentos para _wsearchenv são cadeias de caracteres de largo- caractere._wsearchenv e _searchenv se comportam de forma idêntica.

Se filename é uma cadeia de caracteres vazia, essas funções ENOENTde retorno.

Se filename ou pathname são um ponteiro de NULL , o manipulador inválido do parâmetro é invocado, como descrito em Validação de parâmetro.Se a execução é permitida continuar, essas funções retornam -1 e errno definido como EINVAL.

Para obter mais informações sobre errno e os códigos de erro, consulte errno constantes.

Em C++, essas funções têm as sobrecargas que chamam o mais recente, mais seguros contrapartes do modelo dessas funções.Para obter mais informações, consulte Proteger Overloads de modelo.

Mapeamentos da rotina de Genérico- texto

Rotina de Tchar.h	_UNICODE e não definidos _MBCS	_MBCS definido	_UNICODE definido
_tsearchenv	_searchenv	_searchenv	_wsearchenv

Requisitos

Rotina	Cabeçalho necessário
_searchenv	<stdlib.h>
_wsearchenv	<stdlib.h> ou <wchar.h>

Para mais informações, consulte Compatibilidadede compatibilidade.

Exemplo

// crt_searchenv.c
// compile with: /W3
// This program searches for a file in
// a directory that's specified by an environment variable.

#include <stdlib.h>
#include <stdio.h>

int main( void )
{
   char pathbuffer[_MAX_PATH];
   char searchfile[] = "CL.EXE";
   char envvar[] = "PATH";

   // Search for file in PATH environment variable:
   _searchenv( searchfile, envvar, pathbuffer ); // C4996
   // Note: _searchenv is deprecated; consider using _searchenv_s
   if( *pathbuffer != '\0' )
      printf( "Path for %s:\n%s\n", searchfile, pathbuffer );
   else
      printf( "%s not found\n", searchfile );
}