_searchenv, _wsearchenv

Artigo
06/09/2015

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

Importante

Não é possível usar essa API em aplicativos executados no Tempo de Execução do Windows.Para obter mais informações, consulte Funções CRT sem suporte pelo /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 a ser pesquisado.
varname
Ambiente a ser pesquisado.
pathname
Buffer para armazenar o caminho completo.

Comentários

A rotina _searchenv pesquisa o arquivo de destino no domínio especificado. A variável de varname pode ser qualquer ambiente ou variável definida pelo usuário para o exemplo, o PATH, o LIB, ou o INCLUDE— de que especifica uma lista de caminhos de diretório. Como _searchenv diferencia maiúsculas de minúsculas, varname deve corresponder ao caso de variável de ambiente.

O primeiro rotina procurar pelo arquivo no diretório de trabalho atual. Se não localizar o arquivo, temos pelos diretórios especificados pela variável de ambiente. Se o arquivo de destino estiver 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 terminada em nulo.

O buffer pathname deve ter pelo menos _MAX_PATH caracteres para acomodar o tamanho total do nome de caminho construído. Caso contrário, _searchenv pode passar o buffer de pathname e provocar comportamento inesperado.

_wsearchenv é uma versão de ampla caractere de _searchenvos argumentos, e a _wsearchenv são cadeias de caracteres de ampla caractere. Caso contrário, _wsearchenv e _searchenv, ao contrário, 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 nulo NULL, o parâmetro de manipulador inválido é invocado, como descrito em Validação do parâmetro. Se a execução puder continuar, essas funções retornarão -1 e definirão errno a EINVAL.

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

Em C++, essas funções têm as sobrecargas que invoca o mais recente, mais o modelo contrapartes seguro dessas funções. Para obter mais informações, consulte Sobrecargas de modelo seguras.

Mapeamentos da rotina de texto genérico

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

Requisitos

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

Para obter mais informações de compatibilidade, consulte 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 );
}