PathYetAnotherMakeUniqueName 関数 (shlobj_core.h)

既存のファイル名に基づいて一意のファイル名を作成します。

構文

BOOL PathYetAnotherMakeUniqueName(
  [out]          PWSTR  pszUniqueName,
  [in]           PCWSTR pszPath,
  [in, optional] PCWSTR pszShort,
  [in, optional] PCWSTR pszFileSpec
);

パラメーター

[out] pszUniqueName

種類: PWSTR

一意のファイル名の完全修飾パスを含む null で終わる Unicode 文字列を受け取る文字列バッファー。 バッファー オーバーランの原因にならないように、このバッファーは少なくともMAX_PATH文字長にする必要があります。

[in] pszPath

種類: PCWSTR

新しいファイルを含むフォルダーの完全修飾パスを含む null で終わる Unicode 文字列。 pszShort が NULL に設定されている場合、この文字列には完全な宛先パスが含まれている必要があります。末尾は、新しいファイル名の基になる長いファイル名になります。

[in, optional] pszShort

種類: PCWSTR

一意の名前の基になる短いファイル名を含む null で終わる Unicode 文字列。 長いファイル名に基づいて名前を作成するには、この値を NULL に 設定します。

[in, optional] pszFileSpec

種類: PCWSTR

一意の名前の基になる長いファイル名を含む null で終わる Unicode 文字列。

戻り値

種類: BOOL

一意の名前が正常に作成された場合は TRUE を 返します。それ以外の場合 は FALSE。

注釈

生成されたパスがMAX_PATH文字を超える場合、この関数は PathYetAnotherMakeUniqueName で切り捨てられた文字列を返す可能性があります。 その場合、関数は FALSE を返します。

要件

こちらもご覧ください

PathMakeUniqueName