_putenv, _wputenv
Oluşturur, değiştirir veya ortam değişkenleri kaldırır. Bu işlevlerin daha güvenli sürümlerinde kullanılabilir; see _putenv_s, _wputenv_s.
Önemli
Bu API, Windows çalışma zamanı yürütme uygulamalarda kullanılamaz.Daha fazla bilgi için bkz: /zw ile desteklenmeyen crt işlevlerinin.
int _putenv(
const char *envstring
);
int _wputenv(
const wchar_t *envstring
);
Parametreler
- envstring
Ortam dizesinin tanım.
Dönüş Değeri
Başarılıysa 0 veya –1 olması durumunda bir hata döndürür.
Notlar
_putenv İşlevi yeni ortam değişkenleri ekler veya varolan ortam değişkenlerinin değerlerini değiştirir. Ortam değişkenlerini (örneğin, bir programla bağlantılı olması için kitaplıklar için varsayılan arama yolu) bir işlem yürütür ortamı tanımlamak. _wputenvgeniş karakter sürümü _putenv; envstring bağımsız değişkeni _wputenv bir geniş karakter dizesidir.
Genel metin eşlemeleri yordamına girildi
Tchar.h yordamına girildi |
_UNICODE ve _mbcs tanımlanmamış |
Tanımlanan _mbcs |
Tanımlanan _UNICODE |
|---|---|---|---|
_tputenv |
_putenv |
_putenv |
_wputenv |
envstring Bağımsız değişken bir dize biçiminde bir işaretçi olmalıdır varname=string, varname eklenen veya değiştirilen ortam değişkeninin adıdır ve string değişkenin değeridir. varname Zaten ortamın parçası olan değeri ile değiştirilir string; Aksi halde, yeni varname değişken ve kendi string değeri ortama eklenir. Bir değişkeni boş belirterek ortamından kaldırabilir miyim string — diğer bir deyişle, belirterek yalnızca varname=.
_putenvve _wputenv ; geçerli işleme yerel ortamı etkiler Düzey komut ortamı değiştirmek için kullanamazsınız. Diğer bir deyişle, bu işlevler yalnızca veri yapıları için çalışma zamanı kitaplık erişilebilir ve değil bir işlemde işletim sistemi tarafından oluşturulan ortam kesimi üzerinde çalışır. Geçerli işlem sonlandırıldığında, ortam (çoğu durumda, işletim sistemi düzeyinde) çağırma işleminin düzeyine döner. Ancak, değiştirilmiş ortam tarafından oluşturulan tüm yeni işlemleri için geçirilebilir _spawn, _exec, veya system, ve bu yeni işlemler tarafından eklenen tüm yeni öğeler _putenv ve _wputenv.
Ortam girişi doğrudan değiştirmeyin: Bunun yerine, _putenv veya _wputenv değiştirmek için. Özellikle, öğeleri doğrudan boşaltma _environ[] genel bir dizi ele alınıyor geçersiz bellek neden.
getenvve _putenv genel değişkeni kullanmak _environ ; ortam tablo erişmek için _wgetenvand _wputenv use _wenviron. _putenvve _wputenv değeri değişebilir _environ ve _wenviron, bu nedenle invalidating _envp bağımsız değişkeni main ve _wenvp bağımsız değişkeni wmain. Bu nedenle, kullanmak daha güvenli, _environ veya _wenviron ortamı bilgilere erişmek için. İlişkisi hakkında daha fazla bilgi için _putenv ve _wputenv genel değişkenler için bkz: _environ, _wenviron.
Not
_putenv Ve _getenv işlevlerinin aileleri iş parçacığı açısından güvenli değildir._getenvdize işaretçisi hata döndürmesine neden _putenv rasgele hatalarına neden dize değiştirme.Bu işlevlere olan çağrıları eşzamanlı olduğundan emin olun.
Gereksinimler
Yordamı |
Gerekli başlık |
|---|---|
_putenv |
<stdlib.h> |
_wputenv |
<stdlib.h> veya <wchar.h> |
Daha fazla uyumluluk bilgileri için bkz: Uyumluluk giriş.
Örnek
Nasıl kullanılacağını gösteren bir örnek için _putenv, bkz: GETENV, _wgetenv.
.NET Framework Eşdeğeri
Yoktur. Standart c işlevi çağırmak için kullanın PInvoke. Daha fazla bilgi için bkz: Platform Çağırma örnekleri.