getPackagePathByFullName 函式 (appmodel.h)

取得指定封裝的路徑。

語法

LONG GetPackagePathByFullName(
  [in]            PCWSTR packageFullName,
  [in, out]       UINT32 *pathLength,
  [out, optional] PWSTR  path
);

[in] packageFullName

類型： PCWSTR

封裝的完整名稱。

[in, out] pathLength

類型： UINT32*

變數的指標，其中包含 null 終止符 (WCHARs) 的字元數。

首先，您會將 NULL 傳遞至路徑，以取得字元數。您可以使用這個數位來設定路徑的記憶體空間。然後，您會傳遞此記憶體空間的位址來填滿路徑。

[out, optional] path

類型： PWSTR

接收封裝路徑字串的記憶體空間指標，其中包含 Null 終止符。

類型： LONG

如果函式成功，它會傳回 ERROR_SUCCESS。否則，函式會傳回錯誤碼。可能的錯誤碼包括下列專案。

傳回碼	Description
ERROR_INSUFFICIENT_BUFFER	路徑指定的緩衝區不夠大，無法保存數據。必要的大小是由 pathLength 指定。