共用方式為


FreeEnvironmentStringsA 函式 (processenv.h)

釋放環境字串區塊。

語法

BOOL FreeEnvironmentStringsA(
  LPCH penv
);

參數

penv

環境字串區塊的指標。 呼叫 getEnvironmentStrings 函式,才能取得區塊的指標。

傳回值

如果函式成功,則傳回值為非零值。

如果函式失敗,傳回值為零 若要取得擴充錯誤資訊,請呼叫 getLastError

言論

如果您使用 GetEnvironmentStrings 函式的 ANSI 版本,請務必使用 FreeEnvironmentStrings的 ANSI 版本。 同樣地,如果您使用的 Unicode 版本 GetEnvironmentStrings,請務必使用 FreeEnvironmentStrings的 Unicode 版本。

例子

如需範例,請參閱 變更環境變數

注意

processenv.h 標頭會根據 UNICODE 預處理器常數的定義,將 FreeEnvironmentStrings 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱函式原型的 慣例。

要求

要求 價值
最低支援的用戶端 Windows XP [傳統型應用程式 |UWP 應用程式]
支援的最低伺服器 Windows Server 2003 [傳統型應用程式 |UWP 應用程式]
目標平臺 窗戶
標頭 processenv.h (包括 Windows Server 2003、Windows Vista、Windows 7、Windows Server 2008 Windows Server 2008 R2 上的 Windows.h)
連結庫 Kernel32.lib
DLL Kernel32.dll

另請參閱

環境變數