共用方式為

ExpandEnvironmentStringsForUserA 函式 （userenv.h）

  • 發行項

使用為指定使用者建立的環境區塊展開來源字串。

語法

USERENVAPI BOOL ExpandEnvironmentStringsForUserA(
  [in, optional] HANDLE hToken,
  [in]           LPCSTR lpSrc,
  [out]          LPSTR  lpDest,
  [in]           DWORD  dwSize
);

參數

[in, optional] hToken

類型：HANDLE

使用者令牌，從 LogonUser、CreateRestrictedToken、DuplicateToken、OpenProcessToken或 OpenThreadToken 函式傳回。 令牌必須具有TOKEN_IMPERSONATE和TOKEN_QUERY存取權。 此外，從 Windows 7 起，令牌也必須具有TOKEN_DUPLICATE存取權。 如需詳細資訊，請參閱 Access-Token 物件的存取權限。

如果 hTokenNULL，則環境區塊僅包含系統變數。

[in] lpSrc

類型：LPCTSTR

要展開之 Null 終止來源字串的指標。

[out] lpDest

類型：LPTSTR

接收展開字串之緩衝區的指標。

[in] dwSize

類型：DWORD

指定 TCHAR中 lpDest 緩衝區的大小。

傳回值

類型：BOOL

如果成功，TRUE;否則，FALSE。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。

言論

以下是範例來源字串：

%USERPROFILE%\ntuser.dat

當 ExpandEnvironmentStringsForUser 傳回時，目的地字串會展開，如下所示：

C:\Documents and Settings\UserName\ntuser.dat

注意

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

要求

要求 價值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平臺 窗戶
標頭 userenv.h
連結庫 Userenv.lib
DLL Userenv.dll

另請參閱

使用者配置檔概觀

使用者配置檔參考